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PC -2 Assembly Language 



Article by Bruce Elliott 



This is the first in a series of articles which will describe 
the fvlPU (microprocessor unit) used in the Radio Shack PC-2 
pocket computer. It is our intention to include specific infor- 
mation about the 8-bit CMOS microprocessor, the machine 
code used by the microprocessor, as well as information 
about the PC-2 memory map and certain ROM calls which 
are available. Please realize that much of what we are talk- 
ing about refers to the overall capabilities of the MPU and 
does not imply that all of these things can be done with 
a PC-2. Some known precautions when working with the 
PC-2 include: 

• Po— This signal is not supplied to an external output 
pin on the PC-2. 

• Tl— The Timer Interrupt service routine is not available 
on the PC-2. If a Timer Interrupt occurs, an RTI is 
im.nediately executed. 

• NMI— The Non-Maskable Interrupt is not available to 
the programmer on the PC-2. 

• The MPU signals BRQ and BAK are not supplied to the 
external output pins. 

• Though MEO is available as an output from the MPU, 
DMEO (from one of the support chips) performs a 
similar function and should be used. 

Please understand that the information provided in these 
articles is the only information which is available. We will try to 
clarify any ambiguities which occur in the articles, but can not 
reply to questions outside the scope of these articles. Further, 
published copies of TRS-80 Microcomputer News are the 
only source of this information, and we will not be maintaining 
back-issues. 
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OUTLINE OF THE 8-BIT CMOS MPU 

The 8-bit MPU chip (LH5801) uses CMOS static technol- 



ogy This gives the MPU the low power dissipation inherent to 
CMOS technology The MPU incorporates the LCD back- 
plane signal generator, input port, external latch clock and 
the timer. 

The MPU features: 

• 16 bit address bus 

• 8 bit data bus 

• 8 bit input port 

• DMA and multiprocessor capabilities 

• Contains a WAIT function for memory access control 

• LCD backplane control 

• Clock frequency of 2.6 MHz. 

a. Internal machine cycle of 1.3MHz. 

b. Minimum instruction execution time of 1.3 
microseconds. 

In the PC-2, the MPU performs the following functions: 

• Key input routine 

• Acknowledges remaining program lines 

• Interprets program execution statements 

• Interprets cassette control statements 

• Interprets printer control statements 

• Interprets command statements 

• Display processing routine 

• Arithmetic routines 

• Print routine 

• Instructs I/O chip to perform serial communications, 
sound buzzer, and control counter/timer 
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MPU SIGNALS 

<DD— Output disable signal, when this signal is active, the data bus is in the 
output mode 

<t>OS— This dock signal is in phase with the internal basic clock and is 
supplied to the outside system. 2MHz of the clock frequency is supplied 
when a 4MHz crystal is being used between XLO and XL1 . Smce PC-2 
uses a 2.6MH7 chip, the dock frequency is l.3MHz. 

AD0-AD1 5— Address bus The address bus is tri-state and goes into the 
high impedance state when a Bus Request, BRO. is issued. 
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PH 8 


PL 8 



SH8 


SL8 



P: Program Counter 



S: Slack Pointer 



XH 8 


XL 8 


YH 8 


VL8 


UH8 


UL 8 



X 

V > 



Data Address 



General Purpose Register 



A: Accumulator 

T; Status Register 

C: Carry and Borrow (inter-bytes) 

IE: Interrupt Enable 



-^ Z: Zero Indication 



—^ V: Overflow 

-^ H: Carry Ont«r-digits) 



TM 






TM: Timer Counter 

PU I General Purpose 

PV I Flip-flops 
DISP: LCD Display On/Olf Control 



MPU Intornal Registers and Fhn-flops 

BAK— The BAK output is synchronized with the internal dock. When BAK 
goes high, the Address Bus, Data Bus. MEO, ME 1 . R/W, and <J>D all turn 
to the high impedance stale Not used in PC-2 

3F0. BFI — BFO is an output of the BF flip-flop and BFI is an input to the BF 
flip-flop. The BF flip-flop is normally used lor the memory backup 
system In the PC-2, BFI is connected to Ihe (BREAK) key and goes 
"high" when Ihe (BREAK) key is depressed BFO, in the PC-2, is 
connected to the Chip Select Circuit and the Expansion Port. 

BRO— Bus Request. The MPU responds to the BRQ by turning BAK (Bus 
Acknowledge) high. Not used in PC-2. Tied to GND. 

D0-D7 — Bidirectional data bus through which data is written to or read from 
external memory 

DISP— A flip-flop which IS used to control the on and off action of the LCD 
Instructions are provided to set and reset this flip-flop. 

GND— Ground 

H0-H7— These are Ihe LCD backplane signals 

HA— Output of the MPU internal driver. Divider output of 625 Hz in the PC-2. 
Used by Ihe display chips. 

HIN — LCD backplane signal and an input to Ihe counter that generates HO- 
H7. This IS connected to HA in the PC-2, 

IN0-IN7 — This is the input port which the MPU uses to bring 8-bit data into 
the internal accumulator. Internal pull-up resistance is present. In the 
PC-2, the input port is connected to the keyboard 

MEO, ME1— The Memory Enable signals used by the MPU to directly 
access a maximum of 1 28K bytes in external memory In the PC-2, MEO 
IS connected to the chip select circuit and to Ihe ME1 input of the I/O 
chip. In the PC-2, ME 1 is connected to the MEO input of the I/O chip and 
the expansion port 

Ml — The Maskable interrupt Input signal. The MPU will respond to this 
interrupt request when the Interrupt Enable flag (IE) is on. Interrupt 



processing will begin at Ihe address indicated by FFF8 and FFF9. In the 
PC-2 this IS connected to Ihe INT output of the I/O Chip. 

NMI — The Non-Maskable Interrupt Input. The MPU will respond uncondi- 
tionally and interrupt processing will begin at the address indicated by 
Ihe contents of FFFC and FFFD Not used in Ihe PC-2, tied to GND 

OPF— Operation Code Fetch. Allows Ihe MPU lo fetch an operation (instruc- 
tion) code. OPF appears when an instruction code is fetched, during 
address data and immediate data operations, and when the second 
byte of a two step instruction is being fetched. Not used m the PC-2. 

P<1> — External latch clock The contents of the accumulator is transferred on 
Ihe data bus when this clock is in the high state, and can be used as an 
output port when an external lalch IC is present. Not used in the PC-2 

PU, PV— These are MPU internal flip-flops. Set and reset instructions are 
provided for both PU and PV. In Ihe PC-2, both PU and PV are con- 
nected to the expansion porl PU is one of Ihe enable signals for the 
printer ROM. 

R/W— Memory ReadAVrite Signal. 

RESET— MPU reset input which causes the MPU to reset when a high signal 
is received Program execution begins at Ihe memory address pointed 
lo by Ihe contents of FFFE (low order) and FFFF (high order) Execution 
begins at the indicated address when Ihe RESET input changes from a 
high lo a low stale On the PC-2 this is connected lo Ihe All Reset Switch. 

VA— Power Supply lo the LCD High voltage for segment signals, 1 .2—2.2 
volts 

VB — Power Supply lo the LCD Low voltage for segment signals. 2— 1 2 
volts. 

Vcc— +4.7 volls 

VDIS— Power Supply lo the LCD. +3.7 volts 

Vgg— +4.7 volls 

VM— Power Supply to the LCD. An intermediate voltage used for the com- 
mon and segment signals. .8—16 volls. 

WAIT— When Ihe MPU receives a high signal at the WAIT input, the MPU 
internal clock is hailed lo slop microprogram execution inside the MPU. 
WA is an inlernal flip-flop which accepts the WAIT input at Ihe falling 
edge of Ihe clock oOS and slops the MPU clock when il is in a high stale. 
Connected lo the WAIT output of Ihe I/O chip in the PC-2. This informs 
the CPU when memory or an I/O device is not ready 

XLO, XL1— Crystal connection pins. PC-2 uses a 2.6MHz crystal which 
operates Ihe MPU at a 1.3MHz clock frequency XLO— Input, XL1 — 
Output 

MPU DESIGNATIONS 

A : "A" represents Ihe 8-bit register (accumulator) used for retention of 
arithmetical results or for data transfer with external (non-MPU) memory 

DISP: LCD display on/off control 

P : "P ' represents the 16-bit register (program counter) that indicates the 
next address thai follows the currently executing instruction, and is 
automatically incremented by one when the next instruction is fetched 
The maximum 64K byles addressed by MEO is addressable by P and 
constitutes the program area. 

PH: High order 8 bits of the program counter 

PL: Low order 8 bits of the program counter 

PU: General purpose flip-flop 

PV: General purpose flip-flop 

R : represents any one of Ihe X, Y, or U 16-bit registers. These registers can 
also be used as data pointers When X, Y, or U are used as data pointers, 
it becomes possible lo issue Memory Enable signals, MEO and ME1, 
independently A maximum of 1 28K byles of memory area is available 
lo X, Y, and U (a maximum of 64K byles in the memory area accessed 
by MEO and another 64K bytes in the memory area accessed by ME1 .) 

RH: represents any one of the high order XH, YH, or UH 8-bil registers. 

RL: represents any one of Ihe low order XL, YL, or UL 8-bil registers 

S : "S" represents Ihe 16-bil register (stack pointer) thai indicates the next 
available slack address for the push-down or pop-up stack in memory 
The maximum 64K bytes addressed by MEO is available as Ihe stack 
area 

SH: High order 8 bits of the stack pointer 

SL: Low order 8 bits of the stack pointer 

T : "T" represents Ihe 5-bit register (status register or flags) designed to hold 
status information such as carry (C), borrow (H), zero (Z), overflow (V). 
and interrupt enable (IE). The flags (C, H, Z, V), other than the interrupt 
enable, can be tested by the conditional branch or conditional subrou- 
tine jump instructions. 

TM: "TM" is the 9-bil polynomial counter (timer counter) 

U . 16-bit register 

UH: High order 8 bits of register U 
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UL: Low order 8 bits of register U 

X 16-bit register 

XH High order 8 bits of register X. 

XL. Low order 8 bits of register X. 

Y 16-bit register 

YH High order 8 bits of register Y 

YL: Low order 8 bits of register Y 

OPERATIONAL SYMBOLS 

Signal or data flow 

Signal or data flow 

Logical AND 
V ; Logical OR 
(J> : Exclusive OR 

Arithnnetic addition 

Arithmetic subtraction 

MEMORY AND ADDRESS REPRESENTATION 

Since the Memory Enable signals, MEO and ME1, are 
output from the MPU, the PC-2 microprocessor can directly 
access any area within 128K bytes. MEO takes care of one 
64K byte memory area and ME1 another 64K byte memory 
area. However, MEO is dedicated to program or data areas 
and ME1 to data area only. 
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Memory Enable signal, MEO Memory Enable signal, ME1 

Memory Area accessible by MPU 
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(R) : The contents of the MEO accessible memory that can be specified by the 

register R. 
#(R) The contents of the ME1 accessible memory that can be specified by 

the register R, 
(ab): "a" is a number that represents the high order 8 bits of the address and 

"b" low order 8 bits of the address. Together, they indicate the contents 

of the memory that can be represented by the 1 6 combined bits of a and 

b (MEO accessible). 
#(ab): Same as the above, except that it can be accessed by ME1. 
ab : used in defining the conditional jumps and subroutine calls to designate 

the two hex digits which comprise a single byte immediate value "i". 

STATUS FLAGS 

The status flags. C, V. H. Z, and IE are contained in the 5-bit status 
register The contents of C. V, H, and Z may change Lipon completion of an 
arithmetic instruction. 

Assume that the added results of each bit of the 9-bit full adder are as 
follows: 

Z7. S6. S5. 14, S3. 1'2. II , SO, with carry of C7, C6. C5, C4, C3, C2, CI , CO. 
The input conditions for each of flags shall be as described below; 



07 



C3 



:7-^i;6 * 15- 



06^-07 



(1) Carry flag C — The carry flag C is either set or reset depending on the 
presence of a carry m C7 (8lh bit). 

(2) Half carry flag H — The half carry flag H is either set or reset depending on 
the presence of a carry in C3. 

(3) Zero flag Z — The zero flag Z is dependent on the arithmetic results; it will 
be set when the result is zero, otherwise, it will be reset. 

(4) Overflow flag V— The overflow flag V is set when the arithmetic results of 
one byte is m overflow, provided that the 8th bit is used for a sign with rest 
of the 7 bits for used lor numeric representation 

I/O PORT CHIP 

Contains; 

• two 8 bit bi-directional ports, labeled PA and PB, Each bit in these two ports 

can be programmed as either an input or an output The CPU can 
access PA or PB as one location in memory PA is used for the keyboard 
strobe and PB is used for cassette, counter/timer, and as an interrupt 
input. 

• one 8 bit output port labeled PC. PC can be accessed as one location m 

memory and is used lor counter/timer control and to sound the buzzer 

• Two interrupt request inputs, used with <BREAK> and IRQ inputs from the 

expansion port. 

• one interrupt request output connected to the CPU. 

• CPU WAIT control output Outputs two memory enable signals, DMEO and 

DME1, which are used with memories that have slow access times 

• Controls serial communications The two wait input lines, WO and W1 . are 

used in serial communications 

LCD DISPLAY CHIPS 

Four display chips used for displaying information on the LCD. and as 
memory space for fixed memories E$ - Z$ Display chips 1 and 3 are used for 
the LCD display indicators, and fixed memories E$ - 0$ Display chips 2 and 
4 are used for the LCD display and for fixed memories P$ - Z$. 
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OTHER PARTS OF THE PC.2 SYSTEM 

• Chip Select Decoder Circuit 

• 16K System ROM 

• IK System RAM (two 5514 RAM chips). This RAM is used for fixed 

memories A$ - D$. fixed memories A ■ Z, stack space, the 80 character 
input buffer and is used by FOR-NEXT statements. 

• 2K User RAM (one 6116 RAM chip) This RAM is used for fixed memories 

A27 or A$27 and above as well as being used for Reserve. Program 
and Variable memory 

• Buzzer circuit 

• Counter/Timer circuit 

• Module port 

• Expansion port 

• Keyboard JO 
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Memory Map: 

0000 - 3FFF Module ROM ■ 16K 
4000 • 47FF User RAM ■ 2K 



4800 
7000 
7600 



40(17 f)»><iOfvp Mnrnory pointpfs 

/in?t Mfnii 1 

imB Mpriu 2 

405''i Mnn.j 3 

J0C3 r unclion Key Df*'nihons 

In mark end of function key rtpfmilions 
47FF Ptnqram (Vnftaf)lp) Womofy 

6FFF Module RAM 

75FF Duplicate of 7600 - 7BFF 

76FF Display Chip 1 & 3 

7B00 764D LCD Di-iplay Spclmns 1 g, 3 
Itidir.alo' 



-inoo 
dona 

40 IC 
40S6 
40C4 
40C5 



7(^4 r 



ni 
n\ 1 

Fl.l ? 
FM 1 

n.i 4 

Bl 5 II 
Bil fi I 
Bil 7 Def 

lorlic.lfoi 



Bu'iy 
Shih 
Jn[)aner.e 

Small 
III 



79F.B 

79F0 

79F1 

79F2 

79F3 

79F4 

7ft00 

7A10 

7B10 

7B60 

7B68 

7B69 

7B79 

7B85 

7B87 

7B91 

7BA1 

7BAC 

7BAE 

7BB0 



Printer Text/Graphic morje 



7fiS0 
7r,f,n 
71^70 
7680 
7690 
76AO 
7600 
76C0 
7600 
76E0 
7RF0 



B.fO 
Bil 1 
Bil ? 
Bil 3 
ni 4 
B.f ') 
B'l 6 
Bif 7 
76^)F r$ 
7R(il- F$ 

76 7r r,s 

76RF H% 
76'IF 1$ 
76AF ,)$ 
7fiBF K$ 
76Cf L$ 
76DF M$ 
7fiFF N$ 
76FF OS 



G 
Barl 

Reserve 

Pro 
Hun 



7700 - 77FF Display Chips 2 & 4 

7700 774D LCD Oisplay Seclir>ns 2 & 4 

774E 774F Nol usefJ 

7750 7 75F P$ 

7760 776F 0$ 

7770 777F R$ 

7780 778F S$ 

7790 779F T$ 

77AO 77AF U$ 

77BO 77BF V$ 

77CO 77CF W$ 

77DO 77DF XJ 

77E0 77hF Y$ 

77FO ■ 77FF Z$ 

7800 - 7BFF System Memory - 1K 

7800 7aBF Sy,lpni Memory 19?Byle<; 
RAM lop l-liqfi orrler 8 b-ts 
RAIyl bottom High order 8 bits 



7863 
7864 
78B5 
7867 
7869 

786B 

7R7S 

7879 

7880 

7890 

7894 

7899 

7R9B 

78C0 

7800 

78FO 

7aF0 

7900 

7908 ■ 

7910 

7918 

7920 

7928 

7930 

7938 

7940 

7948 

7950 

7958 

7960 

7968 

7970 

79 78 

7980 

'988 

7'190 

7'<'18 

7'IAO 

'9A8 

7'1B() 

7'IBH 

79C0 

79C8 



7866 FV»qinninq of BASIC prnqram 
7868 EnrI ol BASIC prorir.im 
786A Head address of a BASIC prrxjrae 
on keybcarrl entries 

Beep On'Peep r)lf 

LCD Cursor Position 

CaSsetIP paraniefer F.'F 

LCn rfisiilay parameter F/F 
7893 Used l)y RIGHTS. LEFTS. MIDS 

Stunq Buffer Pointer 7894 . lOH 
789A Start of variable sloraqe area 

Error Code « EHR'2 •■ 1 
7RCF AS 
7S0F BS 

7Hrr (;s 
78Fr 0$ 

7t|07 A 
79or B 
79 1 ! C 
79 IF D 
7927 E 
792F' F 
7'137 G 
79 3F H 
794 7 I 
794 F J 
7957 K 
795F L 
7967 M 
796F N 
7977 O 
797F P 
798 7 O 
79.8F II 
79<>7 S 
799F T 
79A7 i.) 
70AF V 
7ri|17 '// 
7'pHF X 
70(,'7 V 
79(,F / 



to perform edilinq based 



Punier ROTATE value 

Printer pen color 

Printer CSI?E 
7A07 Numeric Data Buffer or String pointer 
7A17 Numeric Data Buffer or String pointer 
7B4F String Buffer 
7B67 Tape out Synchronization header 

Tape out tile mode 
7B78 Tar)e out file name 
7B84 Tape out header (available to user) 
7B86 Tape out » bytes in BASIC lile 1 
7B88 Tape oul end header 
7BA0 Tape in file name 
7BAB Tape m user header 
7BAD Tape m # bytes in BASIC File 1 
7BAF Tape in end header 
7BFF 80 Character Display BuHer 

7C00 ■ 7FFF Duplicate of 7800 - 7BFF 
8000 - BFFF Expansion ROM - 16K 

A519 Change printer pen color 

A769 Printer motor off 

A78t Send ASCII character to pnnler (no LF) 

A8DD Move pen 

A9F 1 Send line leed (LF) to printer 

AA04 Send n line feeds to punier 

AAD9 Pen Up'Down 

ABCB Switch printer from graphic to text mode 

ABEF Switch printer from texl to graphic mode 

BBri6 Write tape synchrooizal'on header 

BBf 5 Finalizalion of ta[ie I/O control 

BCE8 Read tape synchronization header/search for filename 

BD3C ReadWnte file lo tape 

BDCC Send a character to tape 

BDFO Read a character from tape 

BE I 1 Turn \ane drive pn 

BF43 Turn tape drive off 

COOO - FFFF System Program ROM - 16K 

D002 Magnitude Comparison for Numeric Values 

D0F9 Magnitude Comparison tor Character Strings 

D2EA Search for program line number 

0461 Find address of variable 

D925 String concatenation 

D9B1 CHR$ 

D9CF STR$ 

D9D7 VAL 

D90D ASC If YL.60H. LEN it YL.64H 

D9F3 RIGHTS. LEFTS. MIDS 

E243 Keyboard Scan ■ wait for character 

E33F Auto Power OH 

E42C Keyboard Scan • no wart 

E8CA Display contenis o< display buHef 

EDOO Output n characters to LCD using current cursor location 

ED3B Output n characters to LCD beginning at cursor - 

ED40 Output one char to LCD and increnienl cursor position by one 

ED57 Output one character to LCD 

ED95 Convert two bytes ol ASCII code (0^9.A F) into one byte ol hex data 

EDEF Oulput one graphic column to current cursor positron 

EFB6 X - y - X 

EFBA X ♦ Y - X 

EOOB I'OP Flag 2 

FOtA X • Y - X 

F084 X / Y - X 

F0E9 SOB X - X 

F16t I N X - X 

F165 LOG X - X 

FICB EXP X - X 

F1D4 10 - X - X 

F391 COS X - X 

F39E TAN X - X 

F3A2 SIN X - X 

F492 ACS X - X 

F496 ATN X - X 

F49A ASN X - X 

F531 DEG X - X 

F564 DMS X - X 

F597 ABS X - X 

F59D SGN X - X 

F5BE INT X - X 

F89C E«ponen|.aton (X ~ Y - X) 

FFOO - FFF6 Vectors for jumps and calls 
FFF8 - FFF9 Start Address for Ml routine 
FFFA - FFFB Start Address for the Internal Timer 
FFFC - FFFD Start Address for the NMI routine 
FFFE - FFFF Start address for the RESET routine 




79D0 • 7BFF System Memory 560 Bytes 



79F0 79F I I'lnlm < n. 

7<ir.' ''Ml F'r.nUT Y.I. IS rnvjlinn rnl 

79F4 79Fr, 

mFR Pii.ir.r urunson v.iiue 

79r 7 - 79FR 

79E9 F^iinter pen up/down 

79tA Piinlpr ine tvP*' 



rlivr 



In Of'tiin 
lo ori'jin 
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PC-2 Assembly Language- Part 2 



Article by Bruce Elliott 



This is the second in a series of articles which will de- 
scribe the MPU (microprocessor unit) used in the Radio 
Shack PC-2 pocket computer. It is our intention to include 
specific information about the 8-bit CMOS microprocessor, 
the machine code used by the microprocessor, as well as 
information about the PC-2 memory map and certain ROfvl 
calls which are available. Please realize that much of what we 
are talking about refers to the overall capabilities of the (ViPU, 
and does not imply that all of these things can be done with a 
PC-2. 

The information provided in these articles is the only 
information which is available. We will try to clarify any ambi- 
guities which occur in the articles, but can not reply to ques- 
tions outside the scope of these articles. Further, published 
copies of TRS-80 Microcomputer News are the only source of 
this information, and we will not be maintaining back issues. 

Instruction Set 

LOGICAL OPERATIONS 

ADC— The contents of the internal register (PL or RH), or the 
contents of external memory [(R), #(R), (ab), or #(ab)] 
is added into the accumulator including the carry C, 
The result is stored in the accumulator. Flags C, H, Z, 
and V may change after the execution of this 
instruction 



ADI #(U).i 


#(U) ^ 1 


-#(U) 


FD 6F i 3 


17 


ADI #(ab),i 


#(ab) + 


1 - #{ab) 


FD EFabi 5 


23 



Mnemonic Symbolic Operation 



ADC XL 
ADC YL 
ADCUL 
ADCXH 
ADC YH 
ADC UH 
ADC (X) 
ADC (Y) 
ADC (U) 
ADC (ab) 
ADC #(X) 
ADC #(Y) 
ADC #(U) 
ADC #(ab) 



XL + C - A 
YL + C - A 
UL -^ C - A 
XH -I- C - A 
YH -^ C - A 
UH + C - A 
(X) + C - A 
(Y) + C - A 
(U) + C - A 
(ab) ->- C - A 
#(X) + C - A 
#(Y) + C - A 
#(U) -I- C - A 
#(ab) + C - A 



Hex 
Op-Code 

02 

12 

22 

82 

92 

A2 

03 

13 

23 

A3a b 

FD03 

FD 13 

FD23 

FD A3 a b 



Byte Cycle 



6 

6 

6 

6 

6 

6 

7 

7 

7 

13 

11 

11 

11 

17 



ADI— Performs immediate addition to the accumulator or to 
external memory [(R), #(R), (ab), or #(ab)]. Changes 
may take place in C, H, Z, or V The carry flag C will be 
included in the immediate addition to the accumulator. 



ADR— The content of the accumulator is added into the 
register R in 16 bits. Change may take place in C, H, 
Z, or V. 

Hex 
Op-Code 



Mnemonic 




Symbolic Operation 


ADR X 




XL + A - XL 


ADR Y 




YL -^ A - YL 


ADR U 




UL -^ A - UL 


Comment- 


-RH 


-1-1 - RH if C7 = 1 (no 



Byte 


Cycle 


2 


11 


2 


11 


2 


11 



FDCA 
FDDA 
FDEA 
- 1 (no change in CVHZ) 

AND— The content of the accumulator is logically ANDed 
with the content of external memory [(R), #(R), (ab), or 
#(ab)] and the result is stored in the accumulator. 
Change may take place in the Z flag only 

Hex 



Mnemonic 


Symbolic Operation 


Op-Code 


Byte 


Cy 


AND (X) 


A '» (X) - A 


09 


1 


7 


AND (Y) 


A ^ (Y) - A 


19 


1 


7 


AND (U) 


A '^ (U) - A 


29 


1 


7 


AND (ab) 


A '^ (ab) - A 


A9ab 


3 


13 


AND #(X) 


A ^ #(X) - A 


F0 09 


2 


11 


AND (»(Y) 


A '> #(Y) - A 


FD 19 


2 


11 


AND #(U) 


A " #(U) - A 


FD29 


2 


11 


AND #(ab) 


A A #(ab) - A 


FD A9 a b 


4 


17 



Comment — *^ represents the AND operation 

ANI— Logical AND of the accumulator and an immediate 
value, or of external memory [(R), #(R), (ab), or #(ab)] 
and an immediate value with the results stored in the 
accumulator or external memory as indicated. 
Change may take place in the Z flag only 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



ANI A.i 


A ^ 1 - A 


ANI (X).i 


(X) M - (X) 


ANI (Y).i 


(Y) A , _ (Y) 


ANI (U).i 


(U) -^ I - (U) 


ANI (ab),i 


(ab) ^ 1 - (ab) 


ANI #(X),i 


#(X) " i - #(X) 


ANI #(Y).i 


#(Y) '^ i - #(Y) 


ANI #(U),i 


#(U) ' i - #(U) 


ANI #(ab),i 


#(ab) ' ' - #(ab) 



B9i 


2 


7 


49 i 


2 


13 


59 i 


2 


13 


69 i 


2 


13 


E9abi 


4 


19 


FD 49 1 


3 


17 


FD59 i 


3 


17 


FD69I 


3 


17 


FD E9 a b i 


5 


23 



DCA — The content of external memory [(R) or #(R)] including 
the carry C is added to the accumulator in the binary- 
coded-decimal (BCD) system and the result is stored 



Mnemonic 


Symbolic Operation 


Hex 
Op-Code 


Byte 


Cycle 


in 
or 


the accumulator Change may take place in C, H, Z, 
V. 


ADI A.I 


A + 1 + c - A 


B3 1 


2 


7 








Hex 




ADI (XI. i 


(X) + 1 - (X) 


4Fl 


2 


13 


Mnemonic 




Symbolic Operation 


Op-Code 


Byte Cycle 


ADI (Y).i 


(Y) -t- 1 - (Y) 


5Fi 


2 


13 












ADI (U),i 


(U) -t- 1 - (U) 


6F i 


2 


13 


DCA (X) 




A -t- (X) * C - A 


8C 


1 15 


ADI (ab).i 


(cib) -^ • - (.:ib) 


EFa b i 


4 


19 


DCA (Y) 




A -1^ (Yl -I- C - A 


9C 


1 15 


ADI #(X).i 


#(X) ^ ■ - ^(X) 


FD 4F i 


3 


17 


DCA (U) 




A + (U) -^ C - A 


AC 


1 15 


ADI #(Y).i 


#(Y) + 1 - #(Y) 


FD5F 1 


3 


17 


DCA #(X) 




A - #(X) + C - A 


FD8C 


2 19 
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DCA #(Y) 


A 


+ 


#{Y) 


+ 


C - 


- A 


FD9C 


2 


19 


INC X 


X 


+ 


1 


- X 


44 


1 


5 


DCA #(U) 
r»r»c Th^ 


A 


+ 

tr 


#{U) 


+ 


c - 


- A 


FD AC 


2 


19 


INC Y 
INCU 


Y 
U 


+ 
+ 


1 
1 


- Y 

- U 


54 
64 


1 
1 


5 
5 



including the carry C is subtracted from the content of 
the accumulator in the BCD system, and the result is 
stored in the accumulator Change may take place in 
C, H, Z, or V. 

Hex 

Op-Code Byte Cycle 



Mnemonic 


Symbolic Opera 


DCS (X) 


A-(X)-C"- A 


DCS (Y) 


A-(Y)-C - A 


DCS (U) 


A-(U)-C - A 


DCS #(X) 


A - #(X) - C - A 


DCS #(Y) 


A-#(Y)-C - A 


DCS #(U) 


A-#(U)-C - A 



OC 


1 


13 


1C 


1 


13 


2C 


1 


13 


FDOC 


2 


17 


FD 1C 


2 


17 


FD2C 


2 


17 



DEC— Decrements the accumulator or the register (RL, RH, 
or R). Change may take place in C, V, H, and Z for the 
decrement of the accumulator, or the register, RL or 
RH. But no change takes place in flags when the 16- 
bit R is decremented. 

Hex 

Mnemonic Symbolic Operation Op-Code Byte Cycle 



DEC A 


A-1 - A 


DF 


1 


5 


DEC XL 


XL- 1 - XL 


42 


1 


5 


DECYL 


YL-1 - YL 


52 


1 


5 


DECUL 


UL-1 - UL 


62 


1 


5 


DECXH 


XH-1 - XH 


FD42 


2 


9 


DEC YH 


YH-1 - YH 


FD52 


2 


9 


DECUH 


UH-1 - UH 


FD62 


2 


9 


DECX 


X-1 - X 


46 


1 


5 


DECY 


Y-1 - Y 


56 


1 


5 


DECU 


U-1 - U 


66 


1 


5 



EAI— The accumulator is EXCLUSIVE ORed with an immedi- 
ate value and the result is stored in the accumulator 
Change may take place in the Z flag only 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

EAII A i - A BD I 2 7 

Comment— © - represents the XOR operation 

EOR- Logical EXCLUSIVE OR (XOR) of the accumulator 
with external memory [(R), #(R), (ab), or #(ab)] is 
performed and the result is stored in the accumulator 
Change may take place in the Z flag. 

Hex 
n Op-Code Byte Cycle 



Mnemonic 


Symbolic Ope 


EOR (X) 


A © (X) - A 


EOR (Y) 


A © (Y) - A 


EOR (U) 


A © (U) - A 


EOR (ab) 


A © (ab) - A 


EOR #(X) 


A © #(X) - A 


EOR #(Y) 


A © #(Y) - A 


EOR #(U) 


A © #(U) - A 


EOR #(ab) 


A © #(ab)-A 



OD 


1 


7 


ID 


1 


7 


2D 


1 


7 


ADa b 


3 


13 


FOOD 


2 


11 


FD ID 


2 


11 


FD2D 


2 


11 


FD AD a b 


4 


17 



INC— Increments the accumulator or the register (RL, RH, or 
R). Change may take place in C, V, H, and Z for an 
increment of the accumulator, or the registers, RL or 
RH . But no change takes place in flags when the 1 6-bit 
register R is incremented. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



INC A 


A ■»■ 1 - A 


INC XL 


XL + 1 - XL 


INC YL 


YL + 1 - YL 


INCUL 


UL + 1 - UL 


INCXH 


XH -•■ 1 - XH 


INC YH 


YH + 1 - YH 


INCUH 


UH -^ 1 - UH 



DD 


1 


5 


40 


1 


5 


50 


1 


5 


60 


1 


5 


FD40 


2 


9 


FD50 


2 


9 


FD60 


2 


9 



ORA— The accumulator is logically ORed with external 
memory [(R), #(R), or (ab)] and the result is stored in 
the accumulator Change may take place in the Z flag 
only 

Hex 
on Op-Code Byte Cycle 



Mnemonic 


Symbolic Op< 


ORA (X) 


A V (X) - A 


ORA (Y) 


A V (Y) - A 


ORA (U) 


A V (U) - A 


ORA (ab) 


A V (ab) - A 


ORA #(X) 


A V #(X) - A 


ORA #(Y) 


A V #(Y) - A 


ORA #(U) 


A V #(U) - A 


ORA #(ab) 


A V #(ab) - A 



OB 


1 


7 


IB 


1 


7 


2B 


1 


7 


AB ab 


3 


13 


FDOB 


2 


11 


FD IB 


2 


11 


FD2B 


2 


11 


FD ABa b 


4 


17 



Comment— V - represents the OR operation 

ORI— Logical OR of the accumulator or external memory 
[(R), #(R), (ab), or #(ab)] with an immediate value. The 
result is stored in the accumulator or the external mem- 
ory as indicated. Change may take place in the Z flag 
only 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



ORI A.i 


A V i — A 


BBI 


2 


7 


ORI (X).i 


(X) V i - (X) 


4Bi 


2 


13 


ORI (Y),i 


(Y)vi-(Y) 


SB i 


2 


13 


ORI (U),i 


(U) V i - (U) 


6Bi 


2 


13 


ORI (ab),i 


(ab) V i - (ab) 


EBabi 


4 


19 


ORI #(X),i 


#(X) V i - #(X) 


FD4Bi 


3 


17 


ORI #(Y),i 


#(Y) V i - #(Y) 


FD5Bi 


3 


17 


ORI #(U),i 


#(U) V i - #(U) 


.FD6BI 


3 


17 


ORI #(ab),i 


#(ab) V i - #(ab) 


FD EB a b 


5 


23 



SBC— The content of the internal register (RL or RH] or 
external memory [(R), #(R),(ab), or #(ab)] including 
the carry C is subtracted from the accumulator and 
the result is stored in the accumulator Change may 
take place in C, H, Z, or V. 

This operation can be expressed in the following 
manner: The complement of the contents in the inter- 
nal register, RL or RH, or external memory (R), #(R), 
(ab), or #(ab) is first obtained. Then the complement is 
added into the accumulator including the carry C, and 
the result is stored in the accumulator Change may 
take place in C, H, Z, or V. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



SBC XL 


A- 


-XL-C - A 


SBC YL 


A 


-YL-C - A 


SBCUL 


A 


-UL-C - A 


SBCXH 


A- 


-XH-C - A 


SBC YH 


A- 


-YH-C - A 


SBC UH 


A- 


-UH-C"- A 


SBC (X) 


A- 


-(X)-C - A 


SBC (Y) 


A- 


-(Y)-C-A 


SBC (U) 


A- 


-(U)-C - A 


SBC (ab) 


A- 


-(ab)-C - A 


SBC #(X) 


A- 


-#(X)-C -A 


SBC #(Y) 


A- 


-#(Y)-C -A 


SBC #(U) 


A- 


-#(U)-C -A 


SBC #(ab) 


A- 


-#(ab)-C -A 



00 




6 


10 




6 


20 




6 


80 




6 


90 




6 


AO 




6 


01 




7 


11 




7 


21 




7 


A1 ab 


3 


13 


FD01 


2 


11 


FD 11 


2 


11 


FD21 


2 


11 


FD A1 a b 


4 


17 



SBI— The immediate value including the carry C is sub- 
tracted from the accumulator and the result is stored in 
the accumulator Change may take place in C, H, Z, 
or V 



40 
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Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

SBI A.i A-i-C*- A B1 i 2 7 

COMPARISONS, BIT TESTS 

Bll— The accumulator or external memory [(R), #(R), (ab), or 
#(ab)] is logically ANDed with an immediate value. The 
result of the test is in the Z flag. Change may take place 
in the Z flag only. 



Mnemonic Symbolic Operation 



Hex 
Op-Code 



Byte Cycle 



Bll A.i A '^ I - Z BF i 2 7 

Bll (X).l (X) * I - Z 40 i 2 10 

Bll (Y),i (Y) A i _ Z 5D I 2 10 

BII(U).i (U)'^i-Z 6Di 2 10 

Bll (ab),i (ab) '> i - Z ED a b I 4 16 

Bll #(X),I #(X) -^ i - Z FD 4D i 3 14 

BII#(Y),i #(Y)'^i-Z FD5Di 3 14 

Bll #(U).i #(U) '» i - Z FD 6D I 3 14 

Bll #(ab),i #(ab) '» i - Z FD ED a b i 5 20 
Comment—'^ - represents the AND operation 

BIT— The accumulator is logically ANDed with external 
memory [(R), #(R). (ab), or #(ab)]. The result is in Z. 
Change may take place in the Z flag only. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



BIT(X) 


A«(X)- Z 


BIT(Y) 


A'(Y)-Z 


BIT (U) 


A''(U)-Z 


BIT (ab) 


A * (ab) - Z 


BIT#(X) 


A « #(X) - Z 


BIT#(Y) 


A * #(Y) - Z 


BIT #(U) 


A '* #(U) - Z 


BIT #(ab) 


A " #(ab) - Z 



OF 


1 


7 


IF 


1 


7 


2F 


1 


7 


AFab 


3 


13 


FDOF 


2 


11 


FD IF 


2 


11 


FD2F 


2 


11 


FD AF a b 


4 


17 



CPA— Compares the contents of the accumulator with that of 
the register, RL or RH, or external memory, (R), #(R), 
(ab), or #(ab). Change may take place in C, V, H, or Z. 

Hex 

Mnemonic Symbolic Operation Op-Code Byte Cycle 



CPA XL 


A-XL 






06 




6 


CPAYL 


A-YL 






16 




6 


CPAUL 


A-UL 






26 




6 


CPAXH 


A-XH 






86 




6 


CPA YH 


A-YH 






96 




6 


CPAUH 


A-UH 






A6 




6 


CPA (X) 


A-(X) 






07 




7 


CPA(Y) 


A-{Y) 






17 




7 


CPA (U) 


A-(U) 






27 




7 


CPA (ab) 


A-(ab) 






A7ab 


3 


13 


CPA #(X) 


A-#(X) 






FD07 


2 


11 


CPA#(Y) 


A-#(Y) 






FD 17 


2 


11 


CPA #(U) 


A-#(U) 






FD27 


2 


11 


CPA #(ab) 


A-#(ab) 






FD A7 a b 


4 


17 


Comment - 


-If 


C 


z 


V H 








A>op 


1 





• • 








A-op 


1 


1 


• • 








A<op 








• • 







V and H may change depending upon the arithmetic result of the 
compare. 

CPI— The content of the accumulator or the register RL or 
RH, is compared with the immediate value, i. Change 
may take place in C, V, H or Z. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



CPIYL.i YL-i 

CPIUL.i UL-i 

CPI XH,i XH-i 

CPlYH.i YH-i 

CPI UH,i UH-i 

Comment— If C 

(op) > i 1 

(op) - i 1 

(op) < i 



5Ei 
BE i 
40 i 
5Ci 
60 i 
V H 



2 7 

2 7 

2 7 

2 7 

2 7 



V and H may change depending upon the arithmetic result of the 
compare. 

LOADS, STORES 

ATT— The content of the accumulator is transferred to the T 
register. All flags are subject to change depending on 
the content of A. 

Hex 
Op-Code 



Mnemonic Symbolic Operation 

ATT A- T 

Comment— T - Status Register 



FDEC 



Byte Cycle 

2 9 



LDA— The content of the register, RL or RH, or external 
memory [(R), #(R), (ab), or #(ab)] is loaded into the 
accumulator. When the content loaded is "00", it sets 
the flag Z. No change is made with respect to other 
flags. 

Hex 



Mnemonic Symbolic Operation 


Op-Code 


Byte 


Cycle 


LDA XL XL - A 


04 




5 


LDA YL YL - A 


14 




5 


LDA UL UL - A 


24 




5 


LDA XH XH - A 


84 




5 


LDA YH YH - A 


94 




5 


LDA UH UH - A 


A4 




5 


LDA (X) (X) - A 


-05 




6 


LDA (Y) (Y) - A 


15 




6 


LDA (U) (U) - A 


25 




6 


LDA (ab) (ab) - A 


A5ab 


3 


12 


LDA #(X) #(X) - A 


FD05 


2 


10 


LDA #(Y) #(Y) - A 


FD 15 


2 


10 


LDA #(U) #(U) - A 


FD25 


2 


10 


LDA #(ab) #(ab) - A 


FD A5 a b 


4 


16 


LDE— The content of the register 


R is decrementec 


upon 


loading the content of the external memory (R) into the 


accumulator Change may 


take place only in 


theZ 


flag. 


Hex 






Mnemonic Symbolic Operation 


Op-Code 


Byte 


Cycle 


LDE X (X) - A, X - 1 - X 


47 


1 


6 


LDE Y (Y) _ A, Y - 1 - Y 


57 


1 


6 


LDE U (U) - A, U - 1 - U 


67 


1 


6 



LDI— The immediate value is loaded into the accumulator, 

register (RL or RH), or the stack pointer S. Only the 

immediate value being placed in S may contain 2 

bytes. When using LDI A,i the Z flag may change. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



LDI A.i 
LDI XL.i 
LDI YL.i 
LDI UL,i 
LDI XH,i 
LDI YH.i 
LDI UH,i 
LDI S,i,j 

LDX 



CPI A.i 
CPI XL.i 



A-i 
XL-i 



B7i 
4Ei 



B5 i 2 6 

4A i 2 6 

5A i 2 6 

6A i 2 6 

48 i 2 6 

58 i 2 6 

68 i 2 6 

AAij 3 12 

-The content of the register R, stack pointer S, or 

program counter P is loaded into the X register. No 
change takes place in flags. 



- A 

- XL 

- YL 

- UL 

- XH 

- YH 

- UH 

- SH, j - SL 
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Hex 




Mnemonic 


Symbolic Operation 


Op-Code 


Byte 


LDX X 


X - X 


FD08 


2 


LDXY 


Y - X 


FD 18 


2 


LDX U 


U - X 


FD28 


2 


LDXS 


S - X 


FD 48 


2 


LDX P 


P - X 


FD58 


2 



Cycle 



LIN — Increments R upon loading the content of the external 
memory (R) into the accumulator Change may take 
place only in the Z flag. 



Hex 
Op-Code 

45 
55 
65 



Byte 

1 
1 
1 



Cycle 

6 
6 
6 



Mnemonic Symbolic Operation 

LIN X (X) - A. X + 1 - X 

LIN Y (Y) - A. Y + 1 - Y 

LIN U (U) - A, U + 1 - U 

POP— The contents placed on the stack by PSH is returned 
to the accumulator, A or the register, R. POP incre- 
ments S by one in the case of the accumulator, and 
increments S by two in the case of a register. The Z 
flag may change as a result of the POP. 

Hex 
Symbolic Operation 

(S + 1) - A, S+1 - S 

(S+1) - XH. 

(S + 2) - XL. S + 2 - S 

(S + 1) - YH, 

(S + 2) - YL, S + 2 - S 

(S + 1) - UH. 

(S + 2) - UL S + 2 - S 



Mnemonic 

POP A 
POPX 

POP Y 

POP U 



Op-Code 

FD8A 

FDOA 
FD 1A 



Byte 

2 



Cycle 

12 

15 
15 



FD2A 



15 



PSH— The content of the accumulator A or register R is 
stacked into the memory location specified by S. PSH 
decrements S by one in the case of the accumulator, 
and decrements S by two in the case of the register R. 
No change takes place in flags. 

Hex 
Mnemonic Symtralic Operation Op-Code Byte Cycle 

PSH A A - (S). S - 1 - S FD C8 2 11 

PSH X XL - (S), 

XH - (S-1). S-2 -S FD88 2 14 

PSH Y YL - (S), 

YH - (S-1), S-2 -S FD 98 2 14 

PSH U UL - (S), 

UH - (S-1), S-2 -S FDA8 2 14 

SDE— The register R is decremented after the content of the 

accumulator is stored in external memory (R). No 

change takes place in flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

SDE X A - (X), X - 1 - X 43 1 6 

SDE Y A - (Y), Y - 1 - Y 53 1 6 

SDE U A-(U). U-1-U 63 1 6 

SIN— The register R is incremented after content of the accu- 
mulator is stored in external memory (R). No change 
takes place in flags. 



Hex 
Op-Code 

41 
51 
61 



Byte Cycle 

1 6 

1 6 

1 6 



Mnemonic Symtwilc Operation 

SIN X A - (X). X+1 - X 

SIN Y A - (Y), Y + 1 - Y 

SIN U A - (U). U + 1 - U 

STA— The content of the accumulator is stored into register, 

RL or RH, or into external memory [(R), #(R), (ab), 

#(ab)]. No change takes place in flags. 

Hex 
Mnemonic Symlsolic Operation Op-Code Byte Cycle 

STA XL A - XL OA 15 

STA YL A - YL 1A 15 

STA UL A - UL 2A 15 



STAXH 
STA YH 
STA UH 
STA (X) 
STA (Y) 
STA (U) 
STA (ab) 
STA #(X) 
STA #(Y) 
STA #(U) 
STA #(ab) 



A - XH 
A - YH 
A - UH 
A-(X) 
A-(Y) 
A-(U) 
A - (ab) 
A - #(X) 
A - #(Y) 
A - #(U) 
A - #(ab) 

STX— The content of the X register 
stack pointer S, or program 
takes place in flags. 

Mnemonic Symbolic Operation 

STX X X - X 

STX Y ' X - Y 

STX U X - U 

STX S X - S 

STX P X - P 



08 

18 

28 

OE 

IE 

2E 

AE ab 

FDOE 

FD 1E 

FD2E 

FD AE a b 



5 

5 

5 

6 

6 

6 

12 

10 

10 

10 

16 



is stored into register R, 
counter P. No change 



Hex 
Op-Code 

FD4A 
FD5A 
FD6A 
FD4E 
FD5E 



Byte Cycle 

2 
2 
2 
2 
2 



TTA— The content of the T register is transferred to the 
accumulator The Z flag may change as a result of this 
operation. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

TTA T - A FD AA 2 9 

Comment— T ■ Status Register 

BLOCK TRANSFER, SEARCH 

AEX— The high order 4 bit digit in the accumulator is ex- 
changed with the lower order 4 bit digit. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



AEX 



A. 







F1 



CIN — The content of the accumulator is compared with the 
content of the external memory (X), the flags C, V, 
H, and Z are set by the compare, then X register is 
incremented. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

CIN A - (X). x+1 - X F7 1 7 

DRL— Performs digit-to-digit forward rotation between the 
accumulator and external memory, ((X) or #(X)). No 
change takes place with respect to flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

1 



DRL (X) 
DRL #(X) 



LI 



s 



D7 
FD D7 



12 
16 



A (X) or #(X) 

DRR— Performs digit-to-digit backward rotation between the 

accumulator and external memory [(X) or #(X)]. No 

change takes place with respect to flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

r- — > — -I r^ 



DRR (X) 
DRR #(X) 



-t=t: 



^ 



D3 
FD03 



12 
16 



A (X) or #(X) 

ROL— Forward rotation is made between the accumulator 
and the flag C. Flags C. V, H, and Z are subiect to 
change. Hex 

Mnemonic Symbolic Operation Op-Code Byte Cycle 

ROL I. m. r^ — n I db i 6 



'-fci^ rr-Fi J 
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ROR— Backward rotation is made between the accumulator 
and the flag C. Flags C, V, H, and Z are subject to 
change. 



NOP— No operation 



Mnemonic 

ROR 



Symbolic Operation 

L}n- rT~Ti J 



Hex 
Op-Code 

D1 



Byte Cycle 

1 9 



SHL— The content of the accumulator is shifted to the left. 
Flags C, V, H, and Z are subject to change. 



SHL 



D9 



SHR— The content of the accumulator is shifted to the right. 
Flags C, V, H, and Z are subject to change. 



SHR 



- 



D5 



1 



TIN— The content of the external memory (X) is transferred 

into the external memory (Y), the X and Y registers are 

then incremented. No change takes place in flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

TIN 

' ■ ' ■ F5 



(X) - (Y), 

X + 1 _X, Y+1 -Y 



1 



INPUT/OUTPUT 

AMO— The contents of the accumulator is transferred timer 
Since the timer is composed of a 9-bit polynomial 
counter, the content of the accumulator is set in the 1 st 
through 8th bits of the counter and "0" is set in the 9th 
bit. It causes no change in flags. 

Hex 
Mnemortic Symbolic Operation Op-Code Byte Cycle 

AMO A - Timer (0-7) 

- Timer (8) FD CE 2 9 

AMI —Same as AMO, except that "1 " is set in the 9th bit. It 
causes no flag changes. 



AM1 



A — Timer (0-7) 
1 - Timer (8) 



FDDE 



ATP— Sends the content of the accumulator to the external 
data bus. It causes no flag change. 

Hex 
Mnemonic SymlMilc O)>eratlon Op-Code Byte Cycle 

ATP A - Data Bus FD CC 2 9 

CDV— Clears the internal divider. It causes no flag changes. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

CDV - Divider FD 8E 2 8 

HLT— The f\/IPU is put into a halt state when this instruction is 
executed, except that the divider is still in operation. 
MPU operation can be resumed by means of the 
interrupt. No changes in flags occur 

Hex 

Mnemonic Symbolic Operation Op-Code Byte Cycle 

HLT FD B1 2 9 

ITA— The contents of the input IN is transferred to the accu- 
mulator Change may take place in the Z flag, but there 
will be no change in other flags. 

Hex 

Mnemonic Symbolic Operation Op-Code Byte Cycle 

ITA IN - A FD BA 2 9 



Hex 



Mnemonic Symbolic Operation Op-Code Byte Cycle 

NOP 38 1 5 

OFF— Resets the BF flip-flop. It causes no change in the 
flags. 

Hex 

Mnemonic Symbolic Operation Op-Code Byte Cycle 

OFF - BF FD 4C 2 8 



RDP— Resets display flip-flop. 



Hex 



Mnemonic SymlKJilc Operation Op-Code Byte Cycle 

RDP - Display FD CO 2 8 

REC— Resets the carry flag C off. It causes no change in 
other flags. 

Hex 
Mnemonic Syml>ollc Operation Op-Code Byte Cycle 

REC - C F9 14 

RIE— Resets the Interrupt Enable (IE) flip-flop off. It causes no 
change in other flags. 

Hex 
Mnemonic Symlxjilc Operation Op-Code Byte Cycle 

RIE ■ - IE FD BE 2 8 

RPU— Resets the general purpose flip-flop PU off. It causes 
no change in other flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

RPU - PU E3 14 

RPV— Resets the general flip-flop PV off. It causes no 
change in other flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

RPV - PV B8 14 



SDP— Sets display flip-flop. 



Hex 



Mnemonic Symbolic Operation Op-Code Byte Cycle 

SDP 1 - Display FD C1 2 8 

SEC— Sets the carry flag C on. It causes no change in other 

flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

SEC 1 - C FB 14 

SIE— Sets the Interrupt Enable (IE) flip-flop on. It causes no 
change in other flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

SIE 1 - IE FD 81 2 8 

SPU— Sets the general purpose flip-flop PU on. It causes no 
change in other flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

SPU 1 - PU El 14 

SPV— Sets the general purpose flip-flop PV on. It causes no 
change in other flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

SPV 1 - PV A8 14 
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Pocket Computer 



PC-2 Assembly Language-Part 3 



By Bruce Elliott 



This is the third in a series of articles which will describe 
the MPU (microprocessor unit) used in the Radio Shack 
PC-2 pocket computer It is our intention to include specific 
information about the 8-bit CMOS microprocessor, the ma- 
chine code used by the microprocessor, as well as informa- 
tion about the PC-2 memory map, and certain ROM calls 
which are available. Please realize that much of what we 
are talking about refers to the overall capabilities of MPU, 
and does not imply that all of these things can be done with a 
PC-2. 

The information provided in these articles is the only 
information which is available. We will try to clarify any ambi- 
guities which occur in the articles, but can not reply to ques- 
tions outside the scope of these articles. Further, published 
copies of TRS-80 Microcomputer News are the only source of 
this information, and we will not be maintaining back issues. 
Parts One and Two of this series were published in the March 
and April issues, respectively. 

JUMPS/BRANCHES 

BCH— Causes a relative jump to a new program area that is 
determined by adding/subtracting the immediate 
value i to/from the program counter P. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 



BCH + i 


P■^l-P 


8E i 


2 


8 


BCH-i 


P-i-P 


9Ei 


2 


9 



BCR— Conditional relative jump instruction. The relative 
jump is made when "C = 0'.' If "0 = 1" control pro- 
ceeds to the next instruction. It causes no flag 
changes. 





Hex 




Mnemonic Symbolic Operation 


Op-Code 


Byte Cycle 


BCR + i if C = 0. P + i-P 


81 i 


2 8-11 


BCR-i if C = 0. P-i-P 


91 i 


2 8-11 


Comment— If C = 1 . no jump 







BCS— Conditional relative jump instruction. When the condi- 
tion "C = 1 " is met, a relative jump is made to the 
program area that is found after adding/subtracting 
the immediate value i to/from the program counter P. If 
"C = 0", control proceeds to the next instruction with- 
out making the relative jump. It causes no flag 
change. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

BCS-t-i if C=1. P-i-l-P 83 I 2 8-11 

BCS -I ,fC=l, P-i-P 93 i 2 8-11 

Comments— if C = 0, no jump 

BHR— A relative jump is made when "H=0". If "H = 1',' 
control proceeds to the next instruction. It causes no 
flag changes. 





Hex 




Mnemonic Symbolic Operation 


Op-Code 


Byte Cycle 


BHR + i ifH = 0. P-fi-P 


85 i 


2 8-11 


BHR-i if H = 0. P-i-P 


95 i 


2 8-11 


Comment— if 1-1 = 1, no jump 







BHS— A relative jump, is made when "H = 1 '.' If "H = 0',' con- 
trol proceeds to the next instruction. It causes no flag 
changes. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

BHS-fi if H=1, P + i-P 87 i 2 8-11 

BHS-i if H = 1. P-I-P 97 i 2 8-11 

Comment— if H = 0. no jump 

BVR— A relative jump is made when "V = 0'.' If "V = 1 ',' control 
proceeds to the next instruction. It causes no flag 
changes. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

BVR-i-i if v = 0, P + i-P 8D i 2 8-11 

BVR-i if V = 0, P-i-P 9D i 2 8-11 

Comment— if V = 1 , no jump 

BVS— A relative jump is made when "V = 1 '.' If "V = 0" control 
proceeds to the next instruction. It causes no flag 
changes. 





Hex 




Mnemonic Symbolic Operation 


Op-Code 


Byte Cycle 


BVS + i ifV=1, P + i-P 


8Fi 


2 8-11 


BVS-i if V=1. P-i-P 


9Fi 


2 8-11 


Comment— if V = 0. no jump 







BZR— A relative jump is made when "Z = 0'.' If "Z = 1 ',' control 
proceeds to the next instruction. It causes no flag 
changes. 



Mnemonic Symbolic Operation 

BZR + i if Z = 0. P + i-P 

BZR-i ifZ = 0, P-i-P 

Comment— if Z= 1, no jump 



Hex 
Op-Code 

89 i 
99 i 



Byte Cycle 

2 8-11 

2 8-11 



BZS— A relative jump is made when "Z = 1 '.' If "Z = 0',' control 
proceeds to the next instruction. It causes no flag 
changes. 





Hex 




Mnemonic Symbolic Operation 


Op-Code 


Byte Cycle 


BZS + i ifZ=1. P + i-P 


8B i 


2 8-11 


BZS-i ifz=1. P-i-P 


98 i 


2 8-11 


Comment— if Z = 0. no jump 







JMP— Causes a jump to a new program area implied by the 
immediate value in the second and third bytes. It 
causes no flag change. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

JMP i.j i-PH, i-PL BAij 3 12 
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LOP— This instruction causes a relative jump to a new pro- 
gram area if, when UL is reduced by 1, no borrow 
occurs (i.e., UL remains positive or zero). The new 
program area is determined by subtracting the imme- 
diate value i from P. If a borrow occurs when UL is 
reduced by 1, no jump takes place and execution 
proceeds to the next instruction. It causes no flag 
changes. 

Hex 
Op-Code 

88 i 



Mnemonic 

LOP UL.i 



Symbolic Operation 

UL-1-UL 



Byte Cycle 

2 8-11 



Comment— if borrow = 1, no jump; if borrow =0, P-i — P 

CALLS 

SJP— Makes a subroutine jump to the address specified by 
the immediate values i and j. At the same time, the 
address of the next instruction is stored in the stack. It 
causes no flag changes. 



Mnemonic 

SJP 



Symbolic Operation 

PL-(S). PH-(S-I), 
S-2-S. i-PH, j-PL 



Hex 
Op-Code 

BE 1 1 



Byte Cycle 

3 19 



VCR— Conditional vector subroutine jump. When "C = 0',' 
the vector subroutine jump is performed. If "C = 1 ',' the 
control proceeds to ttie next instruction. The Z flag is 
reset after the jump. VCR uses FFOO through FFF6 as 
its vector address table, and the values 00 through F6 
are valid for the immediate value. 



Hex 
Op-Code 

CI i 



Byte Cycle 

2 8-21 



Mnemonic Symbolic Operation 

VCR i ifC = 0, 

PH-(S-1), PL-(S) 
(FFab)-PH, (FFab-H)-PL 
S-2-S 

Comment— if C = 1, no jump, ab = Hex digits in i 



VCS— Conditional vector subroutine jump. When "C = 1 ',' it 
performs the vector subroutine jump. If "C = 0',' the 
control proceeds to the next instruction. The Z flag is 
reset after the jump. VCS uses FFOO through FFF6 as 
its vector address table and the values 00 through F6 
are valid for the immediate value. 



Hex 
Op-Code 

C3 i 



Byte Cycle 

2 8-21 



Mnemonic Symbolic Operation 

VCSi ifC = 1, 

PH-(S-I). PL-(S) 
(FFab)-PH. (FFab+1)-PL 
S-2-S 

Comment— if C = 0, no jump, ab = Hex digits in i 



VEJ— Vector subroutine jump. VEJ is a one byte instruction 
which makes a subroutine jump based on a vectored 
address. The vector table is located in memory from 
FFOO to FFF6. The Z flag is reset after the vector jump 
is executed. 







Hex 






Mnemonic 


Symbolic Operation 


Op-Code 


Byte 


Cy 


VEJ (ab) 


PL-(S), S-1-S 








VEJ (CO) 


PH-(S), S-1-S 


CO 




17 


VEJ (C2) 


(FFab)-PH 


C2 




17 


VEJ (C4) 


(FFab+1)-PL 


C4 




17 


VEJ (C6) 




C6 




17 


VEJ (C8) 




C8 




17 


VEJ (CA) 




CA 




17 


VEJ (CC) 




CC 




17 


VEJ (CE) 




CE 




17 



VEJ (DO) 

VEJ (D2) 

VEJ (D4) 

VEJ (D6) 

VEJ (D8) 

VEJ (DA) 

VEJ (DC) 

VEJ (DE) 

VEJ (EO) 

VEJ (E2) 

VEJ (E4) 

VEJ (E6) 

VEJ (E8) 

VEJ (EA) 

VEJ (EC) 

VEJ (EE) 

VEJ (FO) 

VEJ (F2) 

VEJ (F4) 

VEJ (F6) 

Comment— Where, 



DO 
D2 
D4 
D6 
08 
DA 
DC 
DE 
EO 
E2 
E4 
E6 
E8 
EA 
EC 
EE 
FO 
F2 
F4 
F6 
ab" is the instruction code of VEJ. 



17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 
17 



VHR— Conditional vector subroutine jump. When "H = 0',' 
the vector subroutine jump is performed. If "H = 1',' 
the control proceeds to the next instruction. The Z flag 
is reset after the jump. VHR uses FFOO through FFF6 
as its vector address table and the values 00 through 
F6 are valid for the immediate value. 



Hex 
Op-Code 

C5i 



Byte Cycle 

2 8-21 



Mnemonic Symbolic Operation 

VHR I ifH = 0, 

PH-(S-I), PL-(S) 
(FFab)-PH. (FFab-^1)-PL 
S-2-S 

Comment— if H = 1. no jump, ab = Hex digits in i 



VHS— Conditional vector subroutine jump. When "H = 1 ',' it 
performs the vector subroutine jump. If "H = 0',' the 
control proceeds to the next instruction. The Z flag is 
reset after the jump. VHS uses FFOO through FFF6 as 
its vector address table and the values 00 through F6 
are valid for the immediate value. 



Hex 
Op-Code 

C7i 



Byte 

2 



Cycle 

8-21 



Mnemonic Symbolic Operation 

VHS I ifH = 1. 

PH-(S-I). PL-(S) 
(FFab)-PH, (FFab-^1)-PL 
S-2-S 

Comment— if H = 0, no jump; ab = Hex digits in i 



VMJ — Vector subroutine jump. VMJ is the subroutine jump 
that branches to a vectored address, of which the 
high order byte is composed of "FF',' and low order 
byte is composed of the immediate value i. Note that 
the Z flag is reset after the vector jump, when VMJ is 
executed. VMJ uses FFOO through FFF6 as its vector 
address table, and the values 00 through F6 are valid 
for the immediate value. 







Hex 




Mnemonic 


Symt>oiic Operation 


Op-Code 


Byte Cycle 


VI^J i 


PL-(S), S-1-S 
PH-(S). S-1-S 
(FFab)-PH 
(FFab+ 1)-PL 


CDi 


2 20 


Comments - 


-ab = Hex digits in i 







WS — Conditional vector subroutine jump. When "V = 1',' it 
performs the vector subroutine jump. If "V = 0',' the 
control proceeds to the next instruction. The Z flag is 
reset after the jump. VVS uses FFOO through FFF6 as 
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its vector address table and the values 00 through F6 
are valid for the immediate value. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

WS i ifV = 1, CF i 2 8-21 

PH-(S-1), PL-(S) 

(FFab)-PH, (FFab+1)-PL 

S-2-S 
Comment— if V = 0, no jump: ab = Hex digits in i 

VZR— Conditional vector subroutine jump. When "Z = 0" the 
vector subroutine jump is performed. If "Z = 1 ',' the 
control proceeds to the next instruction. The Z flag is 
reset after the jump. VZR uses FFOO through FFF6 as 
its vector address table and the values 00 through F6 
are valid for the immediate value. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

VZR i ifZ = 0. C9 I 2 8-21 

PH-(S-I), PL-(S) 
(FFab)-PH, (FFab+l)-PL 
S-2-S 
Comment— if Z= 1, no jump; ab = Hex digits in i 

VZS— Conditional vector subroutine jump. When "Z = 1'.' it 
performs the vector subroutine jump. If "Z = 0',' the 
control proceeds to the next instruction. The Z flag is 
reset after the jump. VZS uses FFOO through FFF6 as 
its vector address table, and the values 00 through F6 
are valid for the immediate value. 



Hex 
Op-Code 

CBi 



Mnemonic Symbolic Operation 

VZSi ifZ-1, 

PH-(S-I). PL-(S) 
(FFab)-PH. (FFab + 1)-PL 
S-2-S 

Comment— if Z = 0. no jump; ab = Hex digits in i 



Byte 

2 



Cycle 

8-21 



When a 4MHz crystal oscillator is used, the clock 
produces a oF of 31 .25KHz with a cycle of 32 microseconds. 
In other wrords, the timer counter is incremented once every 
32 microseconds. 



-XLO-f 



L. Yl 1- 



XL1- 



4MHz 
OS 



Divider 



2 1 500 250 125 62.5 

MHz MHz KHz KHz KHz KHz 



31.25 
KHz 




latrl fSSi BD HD C5} CD UD tSi C3) 

ci](w]QoaDCiicDQDa3G0Qfiiaaai^i& 
(7]Q](£]CQQ](H]GQCDfB&aaacia 
B] EQcsi IB OP csiBcd^dijaaaA 
s CD B Gafe3 ESD €!i Si dD a a la a 



RETURNS 



RTI 



Mnemonic 

RTI 



Return instruction from the interrupt subroutine to the 
main routine. All flags are subject to change. 

Hex 
Symlwllc Operation Op-Code Byte Cycle 

(3+1)_PH, 8A 1 14 

(S-t-2)-PL, 

(S-k3)-T. 

S-t-3-S 



RTN— Return instruction from a subroutine to the calling 
routine. RTN causes no changes in the flags. 

Hex 
Mnemonic Symbolic Operation Op-Code Byte Cycle 

RTN (S + 1)-PH. 9A 1 11 

(S-t-2)-PL, 
S-t-2-S 



TIMER 

The timer is composed of a 9-bit polynomial counter and 
the time duration can be set using the AMO and AM1 instruc- 
tions. This counter is in operation at all times, so it needs to be 
set to 000 (Hex) before being used. A timer interrupt request 
can be generated when the content of the counter is 1 FF 
(Hex), if Interrupt Enable IE is on. 

When a timer interrupt occurs, interrupt processing be- 
gins at the address specified in addresses FFFA and FFFB. 
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Pocket Computer 



PC-2 Assembly Language-Part 4 



By Bruce Elliott 



This is the fourth in a series of articles which describe the 
MPU (microprocessor unit) used in the Radio Shack PC-2 
pocket computer. It is our intention to include specific infor- 
mation about the 8-bit CtvlOS microprocessor, the machine 
code used by the microprocessor, as well as information 
about the PC-2 memory map, and certain ROM calls which 
are available. Please realize that much of what we are talking 
about refers to the overall capabilities of the MPU, and does 
not imply that all of these things can be done with a PC-2. 

The information provided in these articles is the only 
■nformation which is available. We will try to clarify any ambi- 
guities which occur in the articles, but can not reply to ques- 
tions outside the scope of these articles. Further, published 
copies of TRS-80 Microcomputer News are the only source 
of this information, and we will not be maintaining back is- 
sues. Parts One, Two and Three of this series were published 
:n the March, April, and May 1983 issues, respectively. 

The first three articles described the MPU used in the 
PC-2, including information on the MPU's structure and its 
machirve language. We also gave you details on the 
PC-2 memory map and the locations of ROM routines which 
are available. In this article we will present two lists v>^hich we 
hope will make finding a particular machine language in- 
struction easier. We will also provide some information on 
now you might begin to use the information we have 
published. 

ALPHABETIC OP-CODE LIST 

The following list presents the PC-2 machine language 
instructions alphabetically along with each code's symbolic 
operation and its hex op-code, and byte count. 

-Parts two and three of this series presented the same 
information arranged according to function and provided 
details on how the instructions work. 



Byte 

4 
2 
2 
2 
3 







Hex 


Mnemonic 


Symbolic Operation 


Op-Code 


•ADC #(ab) 


A + #(ab) -1- C - A 


FD A3 a b 


ADC #{U) 


A-i- #{U) -1- C - A 


FD23 


ADC #{X) 


A+ #(X) + C - A 


FD03 


ADC #(Y) 


A■^ #(Y) + C -^A 


FD 13 


ADC (ab) 


A ■*• (ab) -H C - A 


A3ab 


ADC (U) 


A -1- (U) ■^ C - A 


23 


ADC (X) 


A * (X) + C - A 


03 


AtXC) 


A * (Y) -t- C - A 


13 


ADCUH 


A -^ UH + C -* A 


A2 


.ADCUL 


A -^ UL + C - A 


22 


ADCXH 


A -^ XH + C - A 


82 


ADC XL 


A ■^ XL + C -> A 


02 


ADC YH 


A * YH + C - A 


92 


ADC YL 


A + YL ■<■ C -^ A 


12 


ADI #(ab),! 


#(ab) + 1 -> fli(ab) 


FD EF a b 


AD! #(U),i 


#(U) + 1 -« #(U) 


FD6Fi 







Hex 


Mnemonic 


Symbolic Operation 


Op-Code 


ADI #(X),i 


#(X) + i - #(X) 


FD4Fi 


ADI #(Y),i 


#(Y) -Hi - #(Y) 


FDSFi 


ADI (ab),i 


(ab) -t- i - (ab) 


EFab! 


ADI (U),i 


(U) + 1 - (U) 


6Fi 


ADI (X),l 


(X) + i - (X) 


4Fi 


ADI (Y),i 


(Y) -H-(Y) 


5Fi 


ADI A,i 


A ■^ i -t- C - A 


B3i 


ADRU 


UL + A - UL 


FDEA 


ADRX 


XL -H A - XL 


FDCA 


ADR Y 


YL + A - YL 


FDDA 



Byte 



AEX 



AMD 
AMI 



AND #(ab) 
AND #(U) 
AND #(X) 
AND #(Y) 
AND (ab) 
AND (U) 
AND (X) 
AND(Y) 

ANI #(ab),i 
ANI #(U),i 
ANI #(X),i 
ANI #(Y),i 
ANI (ab),! 
ANI (U).i 
ANI (X),i 
ANI (Y).i 
ANI A.i 

ATP 

ATT 

BCH-H 
BCH -I 

SCR -I- I 
BCR- I 

BCS+ i 
BCS- i 



7 4 3 


t 



A — Timer (0-7) 

-• Timer (8) 

A — Timer (0-7) 

1 — Timer (8) 

A A #(ab) - A 
A A #(U) - A 
A A #(X) - A 
A A #(Y) -« A 
A A (ab) -« A 
A A (U) -« A 
A A (X) - A 
A A (Y) -« A 

#(ab) A I - #(ab) 
#(U) A I -* #(U) 
#(X) A i - #(X) 
#(Y) A i - #(Y) 
(ab) A i -» (ab) 
(U) A 1 - (U) 
(X) A I - (X) 
(Y) A i - (Y) 
A A I -• A 

A -* Data Bus 

A-T 

P -t- i - P 
P - i - P 

if C = 0, P + 1 - P 
If C=0, P - i - P 

if C = i, P -I- i -» P 
ifC = 1. P - i - P 



F1 



FDCE 
FDDE 



FD A9 a D 

FD29 

FD09 

FD 19 

A9ab 

29 

09 

19 

FD E9 a D I 

FD69! 

FD49i 

FD59i 

E9abi 

69 I 

49 i 

59 i 

B9i 

FDCC 

FDEC 

8Ei 
9Ei 

81 i 
91 1 

83 i 
93 1 



4 

2 

2 
2 

3 
1 
1 
1 

5 
3 
3 
3 
4 
2 
2 
2 
2 

2 

2 

2 
2 

2 
2 

2 
2 
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Mnemonic 


Symbolic Operatic 


BHR+ 1 


if H = 0. P + 1 - P 


BHR- < 


if H=0, P - . ^ P 


BHS+ 1 


if H = 1 . P + 1 -> P 


BHS- 1 


it H = 1 , P - 1 ^ P 


Bll #(ab).i 


#(ab) A i - Z 


Bll #(U),i 


#(U) A i -> 2 


Bll #(X).i 


#(X) A 1 - Z 


Bll #(Y),; 


#(Y) A 1 - Z 


Bll (ab).' 


(ab) A 1 ^ Z 


Bll (U).i 


(U) A 1 - Z 


Bll (X).i 


(X) A 1 -> Z 


Bll (Y),i 


(Y) A 1 - Z 


Bll A.I 


A A ; -« Z 


BIT #(ab) 


A A #(ab) - Z 


BIT #(U) 


A A #(U) - Z 


BIT #(X) 


A A #(X) - Z 


BIT #(Y) 


A A #(Y) - Z 


BIT (ab) 


A A (ab) - Z 


BIT (U) 


A A (U) - Z 


BIT (X) 


A A (X) - Z 


BIT(Y) 


A A (Y) - Z 


BVR+ , 


if V = 0, P + 1 - P 


BVR- i 


ifV = 0, P - 1 -> P 


BVS+ ! 


if V=1, P + 1 - P 


BVS- . 


ifV=1, P - 1 - P 


3ZR+ ' 


if Z = 0. P + i - P 


BZB- ' 


ifZ = 0. P - 1 - P 


B2S+ 1 


if Z = 1 P + 1 - P 


B2S- 1 


if Z = 1 , P - 1 - P 



CDV 

CIN 

CPA #(ab) 
CPA #(U) 
CPA #(X) 
CPA #(Y) 
CPA (ab) 
CPA (U) 
CPA (X) 
CPA (Y) 
CPA UH 
CPAUL 
CPA XH 
CPA XL 
CPA YH 
CPA YL 

CPI A.! 
CPI Uh I 
CPI UL.: 
CPI XH,: 
CPI XL.i 
CPI YH.i' 
CPI YL.. 

(XA #(U) 
DCA #(X) 
DCA #(Y) 



— Divider 

A - (X). X + 1 -> X 

A - #(ab) 
A - #(U) 
A - #(X) 
A - #(Y) 
A - (ab) 
A - (U) 
A - (X) 
A - (Y) 
A - UH 
A - UL 
A - XH 
A - XL 
A - YH 
A - YL 

A - I 
UH - I 
UL - i 
XH - I 
XL - 1 
YH - I 
YL - I 

A + #(U) + C - A 
A + #(X) + C -> A 
A + #(Y) + C ^ A 



Hex 


Op-Code 


85 i 


95 1 


87 i 


97 i 


FD ED a b i 


FD6DI 


FD4Di 


FDSDi 


EDabi 


6D 1 


40 1 


5Di 


BFi 


FD AF a b 


FD2F 


FDOF 


FD IF 


AFab 


2F 


OF 


1F 


8Di 


9Di 


BFi 


9Fi 


89 i 


99 1 


8Bi 


9Bi 



FD8E 



FT 



FD A7 a b 


FD27 


FD07 


FD 17 


A7ab 


27 


07 


17 


A6 


26 


86 


06 


96 


16 


B7i 


6C; 


6Ei 


4Ci 


4Ei 


5Ci 


5Ei 


FDAC 


FD8C 


FD9C 



Byte 

2 
2 

2 
2 

5 
3 
3 
3 
4 
2 
2 
2 
2 

4 
2 
2 
2 
3 
1 
1 
1 

2 
2 

2 
2 

2 
2 

2 
2 



Mnemonic 

DCA (U) 
DCA (X) 
DCA (Y) 

DCS #(U) 
DCS #(X) 
DCS #(Y) 
DCS (U) 
DCS(X) 
DCS(Y) 

DEC A 
DECU 
DEC UH 
DECUL 
DECX 
DEC XH 
DEC XL 
DECY 
DEC YH 
DECYL 



DRL #(X) 
DRL (X) 



DRR #(X) 
DRR (X) 



EAI i 

EOR #(ab) 
EOR #(U) 
EOR #(X) 
EOR #(Y) 
EOR (ab) 
EOR (U) 
EOR (X) 
EOR (Y) 

HLT 

INC A 
INCU 
INCUH 
INCUL 
INCX 
INCXH 
INC XL 
INC Y 
INC YH 
INC YL 

ITA 

JMP i,) 

LDA #(ab) 
LDA #(U) 
LDA #(X) 
LDA #(Y) 



Symbolic Operation 

A + (U) + C -> A 
A + (X) + C - A 
A + (Y) + C - A 

A - #(U) -£- A 
A - #(X) - C - A 
A - #(Y) -_C -^ A 
A - (U) - C - A 
A - (X) - C - A 
A - (Y) - C - A 

A - 1 - A 
U - 1 - U 
UH - 1 - UH 
UL - 1 - UL 
X - 1 - X 
XH - 1 - XH 
XL - 1 - XL 
Y - 1 - Y 
YH - 1 - YH 
YL - 1 - YL 









nl 












( 1 




I 




A 


1 






(X) 


or #(X) 

^ n 


1 














i 1 




1 1 













A (X) or #(X) 

A© i - A 

A #(ab) -- A 
A © #(U) - A 
A © #(X) -> A 
A © #(Y) - A 
A © (ab) - A 
A © (U) -> A 
A © (X) - A 
A © (Y) - A 



A + 1 - A 
U + 1 - U 
UH + 1 - UH 
UL + 1 - UL 
X + 1 - X 
XH + 1 - XH 
XL + 1 - XL 
Y + 1 -> Y 
YH + 1 -^ YH 
YL + 1 -> YL 

IN -^ A 

i - PH, j -> PL 



Hex 


Op-Code 


AC 


8C 


9C 


FD2C 


FDOC 


FD 1C 


2C 


OC 


1C 


OF 


66 


FD62 


62 


46 


FD42 


42 


56 


FD52 


52 


FDD7 


D7 



#(ab) - A 
#(U) - A 
#(X) -> A 
#(Y) - A 



FDD3 
D3 



BDi 

FD AD a b 

FD2D 

FOOD 

FD ID 

ADab 

2D 

OD 

ID 

FDB1 

DD 

64 

FD60 

60 

44 

FD40 

40 

54 

FD50 

50 

FDBA 

BAij 

FD A5 a b 
FD25 
FD05 
FD 15 



Byte' 

1 
1 
1 

2 
2 
2 



22 



TRS-80 Ivlicrocomputer News. September 1983 









Hex 


Mnemonic 


Symbolic Operation 


Op-Code 


LDA (ab) 


(ab) - A 




A5 a b 


LDA (U) 


(U) -A 




25 


LDA (X) 


(X)-A 




05 


LDA (Y) 


(Y)-A 




15 


LDAUH 


UH - A 




A4 


LDAUL 


UL -> A 




24 


LDAXH 


XH -> A 




84 


LDA XL 


XL ^ A 




04 


LDAYH 


YH -► A 




94 


LDA YL 


YL - A 




14 


LDEU 


(U) - A, U - 1 - 


U 


67 


LDEX 


(X) - A, X-1 - 


X 


47 


LDEY 


(Y) - A, Y - 1 -> 


Y 


57 


LDI A,i 


i- A 




B5i 


LDI S.I.) 


1 - SH, ) - SL 




AAij 


LDI UH,i 


1 - UH 




68 1 


LDI UL.i 


i - UL 




6Ai 


LDI XH.i 


i -^ XH 




48 i 


LDI XL.i 


1 - XL 




4A 1 


LDI YH.i 


i - YH 




58 i 


LDI YL.i 


i-> YL 




5Ai 


LDX P 


P - X 




FD58 


LDXS 


S -X 




FD48 


LDXU 


U - X 




FD28 


LDXX 


X - X 




FD08 


LDX Y 


Y -« X 




FD 18 


LINU 


(U) - A, U + 1 - 


U 


65 


LINX 


(X) - A, X+1 - 


X 


45 


LINY 


(Y) - A, Y + 1 -> 


Y 


55 


LOP UL.I 


UL - 1 -* UL 




88 i 




If borrow 


= 0, P - 


1 -> P 



Byte 

3 



NOP 

OFF 

ORA #(ab) 
ORA #(U) 
ORA #(X) 
ORA #(Y) 
ORA (ab) 
ORA (U) 
ORA (X) 
ORA(Y) 

ORI #(ab),l 
ORI #(U),I 
ORI #(X).i 
ORI #(Y),i 
ORI (ab),i 
ORI (U).l 
ORI (X),i 
ORI (Y),i 
ORI A.I 

POP A 
POPU 

POPX 

POP Y 



-> BF 

A V #(ab) - A 
A V #(U) - A 
A V #(X) - A 
A V #(Y) - A 
A V (ab) - A 
A V (U) - A 
A V (X) - A 
A V (Y) - A 

#(ab) V i - #(ab) 
#(U) V I - #(U) 
#(X) V i -> #(X) 
#(Y) V i - #(Y) 
(ab) V I -♦ (ab) 
(U) V I - (U) 
(X) V I - (X) 
(Y)vi-(Y) 
A V i -» A 

(S + 1) -« A, S+1 - S 

(S + 1) -> UH, 

(S + 2) -> UL.S + 2 - S 

(S + 1) - XH, 

(S + 2) -> XL.S + 2 - S 

(S + 1) -* YH, 

(S + 2) - YL,S + 2 - S 



38 



FD4C 



FD AB a b 


FD2B 


FDOB 


FD 1B 


ABab 


28 


OB 


IB 


FD EB a b 


FD6B1 


FD4Bi 


FD5Bi 


EBabi 


6Bi 


4Bi 


5Bi 


BBi 


FD8A 


FD2A 


FDOA 


FD 1A 



4 
2 
2 
2 

3 
1 
1 
1 

5 
3 
3 
3 
4 
2 
2 
2 
2 



Mnemonic 

PSH A 
PSH U 

PSH X 

PSH Y 

RDP 
REC 
RIE 

ROL 



ROR 



Symbolic Operation 

A - (S). S - 1 - S 

UL - (S), 

UH - (S-1), S-2 -S 

XL - (S). 

XH - (S-1), S-2 -*S 

YL - (S), 

YH - (S-1), S-2 -S 

— Display 

0-C -^ ■: kv 



- IE ir 



/■' Y^ 



M'cU't ol-J 



HcT*!? 



Hex 
Op-Code 

FDC8 

FD A8 

FD 88 

FD98 

FDCO 

F9 

FDBE 

DB 
D1 



RPU 


0- PU 




E3 


RPV 


-> PV 


B8 


RTI 


(S+1) - PH. 
(S + 2) - PL, 
(S + 3) - T 
S + 3 - S 


8A 


RTN 


(S+1) - PH, 
(S + 2) - PL, 
S + 2 - S 


9A 


SBC #(ab) 


A - #(ab) - C - A 


FD A1 a b 


SBC #(U) 


A - #(U) - C- A 


FD21 


SBC #(X) 


A - #(X) - C-* A 


FD01 


SBC #(Y) 


A - #(Y) - C- A 


FD 11 


SBC (ab) 


A - (ab) - C- A 


A1 a b 


SBC (U) 


A - (U) - C- A 


21 


SBC (X) 


A - (X) - C- A 


01 


SBC (Y) 


A - (Y) - C^ A 


11 


SBCUH 


A - UH - C- A 


AO 


SBCUL 


A - UL - C-^ A 


20 


SBCXH 


A - XH - C-> A 


80 


SBC XL 


A - XL - C- A 


00 


SBC YH 


A - YH - C^ A 


90 


SBC YL 


A - YL - C- A 


10 


SBI A. 1 


A - i - C-" A 


B1 ; 


SDEU 


A - (U), U-1 - U 


63 


SDEX 


A - (X), X-1 - X 


43 


SDEY 


A - (Y), Y-1 - Y 


53 


SDP 


1 -* Display , ; ' r.. r 


FDC1 


SEC 


1 - C AtC r 


: '—o 


FB 


SHL 


|C -»- 7 ( 


D9 




A 




SHR 


0-* 7 


■*■ C 


D5 



Byte 

2 

2 

2 
2 
2 
1 
2 
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Hex 


Mnemonic 


Symbolic Operation 


Op-Code 


SIE 


1 - 


IE 






FD81 


SINU 


A ^ 


►(U). 


U + 1 


- U 


61 


SINX 


A-^ 


>(X), 


X + 1 


- X 


41 


SIN Y 


A -' 


•(Y). 


Y + 1 


- Y 


51 


SJP 


PL 


-(S) 


, PH 


-*(S-1), 


BEij 




S - 


2 - 


S. i 


- PH. 






J -* 


PL 









SPU 


1 - PU 




El 


SPV 


1 - PV 




A8 


STA #(ab) 


A - #(ab) 




FD AE a b 


STA #(U) 


A - #(U) 




FD2E 


STA #(X) 


A - #(X) 




FDOE 


STA#(Y) 


A-#(Y) 




FD1E 


STA (ab) 


A - (ab) 




AEab 


STA (U) 


A-(U) 




2E 


STA (X) 


A-(X) 




OE 


STA(Y) 


A-(Y) 




IE 


STAUH 


A -► UH 




28 


STAUL 


A - UL 




2A 


STAXH 


A - XH 




08 


STA XL 


A - XL 




OA 


STA YH 


A -> YH 




18 


STAYL 


A - YL 




1A 


STXP 


X - P 




FD5E 


STXS 


X -S 




FD4E 


STXU 


X - U 




FD6A 


STXX 


X - X 




FD4A 


STXY 


X - Y 




FD5A 


TIN 


(X)-(Y), 




F5 




X + 1 - X, Y + 1 - Y 




TTA 


T- A 




FDAA 


VCRI 


ifC-0, 




CI i 




PH -(S-1), 


PL - (S) 






(FFab) - PH 








(FFab + 1) -« 


PL 






S - 2-S 






VCSi 


ifC = 1, 




C3i 




PH -(S-1), 


Pt - (S) 






(FFab) - PH 








(FFab+1) - 


PL 






S - 2 -> S 






VEJ (CO) 


PL - (S), S- 


1 -S 


CO 


VEJ (C2) 


PH - (S), S- 


■1 -S 


C2 


VEJ (C4) 


(FFab) - PH 




C4 


VEJ (C6) 


(FFab+1) - 


PL 


C6 


VEJ (C8) 






C8 


VEJ (CA) 






CA 


VEJ (CC) 






CC 


VEJ (CE) 






CE 


VEJ (DO) 






DO 


VEJ (02) . 






D2 


VEJ (D4) 






D4 


VEJ (D6) 






D6 


VEJ (D8) 






D8 


VEJ (DA) 






DA 


VEJ (DC) 






DC 









Hex 


Byte 


Mnemonic 


Symbolic Operation 


Op-Code 


2 


VEJ (DE) 




DE 




VEJ (EO) 




EO 


1 


VEJ (E2) 




E2 


1 


VEJ (E4) 




E4 


1 


VEJ (E6) 




E6 




VEJ (E8) 




E8 


3 


VEJ (EA) 




EA 




VEJ (EC) 




EC 




VEJ (EE) 




EE 




VEJ (FO) 




FO 


1 


VEJ (F2) 




F2 




VEJ (F4) 




F4 


1 


VEJ (F6) 




F6 


4 


VHRi 


if H-0, 


C5i 


2 




PH - (S-1), PL - (S) 




2 




(FFab) - PH 




2 




(FFab + 1) - PL 




3 




S - 2 - S 






VHSi 


if H = 1 , 

PH- (S-1), PL - (S) 
(FFab) - PH 
(FFab+1) - PL 
S - 2 - S 


C7i 




VMJi 


PL- (S), S-1 - S 
PH -(S), S-1 - S 
(FFab) - PH 


CDi 


2 
2 




(FFab+1) - PL 




2 


WSi 


if V=1, 


CFi 


2 




PH - (S-1), PL - (S) 




2 




(FFab) - PH 
(FFab+1) - PL 




1 




S - 2 - S 






VZRi 


ifZ=0, 


C9i 


2 




PH - (S-1), PL-(S) 




2 




(FFab) -PH 






(FFab + 1) -PL 








S - 2-S 






VZSi 


ifZ = 1, 

PH - (S-1), PL-(S) 

(FFab) -PH 


CBi 


2 




(FFab+1) -PL 
S - 2 -S 





Byte 



lisassa 



I 




in Sfl tB EED CD >^ Q3 SB flB 

(uoieBaaaBBaaaidlaa 



mU ^31 G9 



NUMERIC OP-CODE LIST 

The following list presents the PC-2 machine language 
instructions numerically and includes the hex and decimal 
values for the op-codes. Numeric values which are missing 
from the list have no valid op-code that we are aware of. 
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Hex 
Value 



Decimal 
Value 



Opcode 



00 00 SBC XL 

01 01 SBC iX) 
O; 0? ADC XL 
u> ■■?. ADC ■:'/) 

m--:' ■■/. Ob."- ■■■:(. :''\/:,xD\()(i"^ 

..a .-; .. '-Ar 

09 03 AND iXj 

OA 1 STA XL 



SBC YL 
SBC (Y) 
ADCYL 

DA {y):i 

■ CPAVU - 

'Sli\ YH 

ANDfr") 
2b STA YL 

1 i_ -■ - ^ J ^ .- ^ . yi 




20 
7r/ 



33 
■^4 



SBC Lji. 
SBC (U) 
AOC UL 



■■■■26 .'.■■,'■ ." ■■■ 3fl 

iH -■■ 

29 ■11 

2A 42 

2B <i2 

f.^E.i. ::..■;/:' -' «■; ;.,;'-■■;;■;■;*..■ sta(U!^ 



: .LDA (U)1 
- -CPAUL.-.j 

; I .■ ' ■. . " ' 

AND i\>j 
STA UL 
ORA I'LI'i 



3S 



56 



NOP 



:U-r ;. :-. ^:;' o:65'' ^ ■■■--;■■■,- -^ '' -SifJX''^ 

[42 :■':■. ^ ^ '.; : :■:■.-:-. ":-wcxl > 

44 fcS INC X 

69 LIN X. 

-n r-i=r :.■ 



45 

4 7 

djj i 

4t ; 
^F ■ 



■\^;":-73i ■■ ": 
■■■.■■ 74 I .■ . 



-..■■ . :ANI..{X.t,i::i 
?■"■■;' 10!">:L.-! 

Cp! Xri . 
Bil (X).i 
CPI XL.1 

AO! m. 



pg5 ■ ^i^-'r-^ -'r,^^r^S^'^'yf.''^r^T^}}'Tyf^"'^i 
"sa- . ■. .':_;:;■ s?; ..■■,■■.■;■ ■ decvlI 



56 

57 

■ 59 i ■ ' ■. : ' 
■, SA L ■" . ■■■'. ■ 



37 



I.IN r 
DEC Y 



S9! ■-;■;.■ ,■; ." . ■, /Kf<\ {ipi 
i2 I CPI ''Mj 



Hex 
Valu^ 

5Di 
5Ei 
sf: 



□ecimat 
Value 

93 I 

94 I 
or , 



Opcode 

Bll (Y^.i 
CPI YL ! 
ADI (Yi 



= 62 ■ ,^ , :96 o:.:;^;^r OECUL 

LIN U 



65. 
66 



TOl 
102 



DEC U 



'69 1 ■ V- ■■:■--:,- 1 W ,(:f>i^ ,--"v- \f.m\ (UJ.vd 

:-eA I ■ ■■ ' ■■.■iOEt ' f^yV^--'-^WiULJr^ 

^Bi.;.w.,i<i^^:^7i[^if i^-trf rrif ff"i fl " Ail 

6C i T08 . CPI Uri . 

60 1 109 I BM (U) I 

6E I TIOl CPI UL.: 

6F i Till ADI tU).. 




vjaa 

lDA xh 
BHR-i- ■ 

OP'S. Xi-t 

^7 ■■-;: ShS- 

ear r ■:-.;■;'..■ lar-i^^i'^v " - .v.-"ezR+ <, A 

■ flA' -i;^ ■ '■ \, " 136 ^: "; -^ .•;.■: 'ii'ftTl :--. '^1 

'■■n_. ■ 1...- UCA I '-.; 

3D , "41: BVR ■ ; 

BE I 142 I BCH+ I 

ftp: iri, RVS- 

'■9l': '■'.:'/V'-M45h.'^^,' ■;■■-':-;" -ESCR^i- 
^■92. . ' ■■ r . -<„1^6 •.;■;-;>' ;;/7 ADC VH 



■.^4 


'Air, 


L L^-" ' : ' 


95 1 


T-iy . 


SHR - - 


96 


150 


CPA YH 


•"^7 


i C t 


RiH'^ . 






9D. !57 , tiVH-i 

9E - 156 1 BCH-' 

3F : l^'j . 3VS ■ 

•'.AT a L- ■■""'■■' :-:iBl 3 b ■.■;■_■.-■.;■ x'-.,SSC (abjri 
-■ A£ "."...■■' 1 62 ^ ■ '^r --A. ■ '-■■: ADC: UH ' i 



.AS a o 165 a u LUA fab) 

A6 16fi CPA U'H 

i 7 ;i [1 "S ' -i C CPA r,;-'i 






■■ A9 at: 

J'AA-U 

Ai.: 1 72 

AD i D ' 73 a D 

AEati 174 a b 

AFab iTSab 



^.■A . 



'ANOCatJiri 

■:L:Dis;i' " 

OCA ,uj 
£0R I3D! 
STA {aoj 
BIT (abt 



"Bar .V ■■*■■-; 179 r. ":■>:-■" .v;Ao! A; ' 

^65 i;- ;:\v"-.131 *^■., -.^^^ .^ : LDI A,| 








OpCDCJe 

VEJ (CO} 
VCfl: 
■^'EJ (C2) 
\'CS i 



USii^M^^^^Mii^^m^gii^ma:^ 



cy 1 


201 1 


yzR : 


CA 


ao2 


VEJ (CA> 


rp ■ 


^03 ■ 


'■. ' 7 (: 




DO 


206 


VEJ (DO) 


D1 


209 


ROR 


D2 


210 


VEJ (D2) 




■^?':;-522^'i.?.;--_:'J / Vf^J-(t)Ef-- 



EO 


224 


VEJ lEO^ 


E! 


225 


SPU 


E? 


??n 


VEJ (E2} 


C-? 


;"■ T 7 


RPU 



.■E6' •■■ ■" -.'■'^'"30 • ■ 
?Ee - . ■•.■.■'r..2'ii 



235 a b ; 
336 



VE.1(E6) '■'! 

VEJ'M; 

V^^J ^".■'■.l 

OHi (at-),; 
VEJ fEC} 




rci 
Fi 
F2 
: .1 



241 
242 



VFj I.FO; 

AEX 

VEJ (F2^ 

v'F i '-4. 



^ F^ .: '-^-^^^-i^^-i^Z: ■:-^' f-i^- CIN ^^ 

r iJ ^^1 oFC 



;'fO0.3=P 

Fu 08 
FD 09 
FD OA 



■■""■" ""'^^^iiyEf&ASli 

i:o,j tj.i LuX X 

253 09 AND #IX> 

2&3 lO POP V 






FD lil 
FD 13 
FD 15 



253 17 
253 19 
253 21 



AOC ^(¥5 

LDA n>,'Vi 



-■;- - ji lM^ 



'3.4ljiato,^iit^;^W!l^t,i»0Ui^i;<,^^ 



I'FD 19 ■■:.'5.-:--;>; "253.25 ■■;:'.■" ^-■■.-- AN,D JTri: 



i u 



:;r siY; 
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Hex 

Value 

^ FD IE 



iFD2f 
i FD23 

■■ FD 25 
Up 27 

FD29 
FD 2A 

rFD2C ■ 

^FD 2D 
' FD2b 



FD42 

FD J8 

: Fb4A - 

■■FD4B i 
'i FO 4C 

'"FD 50- ; 
; FD52 

i 



Decimal 

Value 

253 30 

253 35 
^ 2S3 37 
. «.253.39 -i;,. 

253 4^ 
253 42 

'"■•^53'44 '^-' 
; 253 45 
253 46 ' 

;>..553 47^., 



Opcode 

STA #(Y) 
BIT ^(Yi 

"ADCiif(U)* 
;■ .LDAjiftUlJ 

:. DX ,. 

AND S(U1 
POP U 

■EOR-#(U)'i 
■ STA #(U) 3 



253 66 DEC XH 

253 72 LDX S 

• -253 M ■ ■*^!^T'«'^S^^--»^ 
253 '75 f ■■ ':-■■.. ORI #()0;iS 
253 76 ,^;':;:,; "OFF- .;| 



^253 82 -■ " ; DECYH | 



Hex 

Value 



Decimal 
Value 



Opcode 



fTCr-BErT^^!«5?5!'5^?63=89'f5«^^**P^':''^ANI '*<^m 
JFDSA" >■ *^-253S0 :■ : - STX Y ^ 
:• FD-5B i ■.-.:: -"253 91 1^^ ■■'■■.■ ORi #(Y),f -^ 

■" L' -■ ' C ■l'Z ■ '' r! •- .-.1 i / "^ 



"D -jF 



\CI )*(> 



^ F0 62 ■: .■-SV,-253 -98 V;:f^' ' -DEC UK ^ 
i FD 69 r-;^^>'253- 105 (./.:; . ANI #(U).i,:^ 



FD 6D. 
FD6F I 



255 109 
253 111 



Bli #(Ui . 
ADI #(U),i 



PFEmi^?^^3^5S^'H9 fJT^^'^VSSIH'^^'*^^ 



■FD 88'^ 
rFD.^A^: 



POP A -■ ''^'? 



^C- 



:2S3 t36 
253 13e.. 






FD Al a D 
FD A3 a o 
FO A5 a c 



255 161 at 
255 163 a n 
253 165 a D 



SBC =f(ac) 
ADC «(aD) 
IDA i*(aD) 



Hex 

Value 

FD A9 a b 

FD AA 
FD AB a b 
^'D AC 



Decimal 

Value 

253 169 a b 

253 170 
253 171 ab 

?5T 1 7p 



Opcode 

AND #(aDI 
TTA 

ORA #[ab) 
DCA #fui 



^ FD AE ab , 253 174 a 6" -''"STA «ab) "| 



FD B1 
FD BA 
FD B'^ 



253 177 
253 186 
253 190 



■FDC1 "•.;■ ;--253193 
FOGS '-:.-": 253200 

^D CC ^53 2C:-i 

FD CE 253 206 



HLT 
ITA 
RfE 



■■-VPSHA" 



AMQ 



"-"--' ■ .>.V253 215^-?^%V-'-'DRL#{X):^4 
: ;.r.25a 2 1 8 t>>M?F^';- ADR y A 



'*F0D7 
- FDDA : 



FD E9 a b ) 253 233 a b i ANI #(ab).i 

FD EA 253 234 ADR U 

FD EB a b I 253 235 a b i ORi #(ab),i 
FD EC ^5'' ?''6 ATT 

WO 'ECf^T?.r^^53 237^15T^r BTl f (SbTl-^^ 



HOW DO 1 USE ALL THIS? 

The primary advantage of machine language over 
BASIC IS speed. Your PC-2 has a very complete BASIC so 
there really isr; t a lot of reason to program in machine lan- 
guage umess you are iooKmg for a speeo aavantage. Let s 
look at a couple of programs which will demonstrate how fast 
machine language is compared to BASIC. 

What v/e wiN do is write a BASIC program which will 
reverse eacn graphic point on the PC-2's LCD display Any 
point which IS black (on) will be turned white (off) ana any 
point v^mch is otf v^ill be turned on. We will then snow you a 
Similar orcgram m macmne language. This should let you 
compare the speeds of the two languages. 

First the BASIC program: 

im WAIT 3 

2HJ CLS 

12i GCURSOR 3 

: KEM SHIFT PRINTING RIGHT SLIGHTLlf 
23^ PRINT "Microcomputer Sews" 
2Ai FOR 1=0 TO 155 

; REM GRAPHIC COLUMNS 
25(J GCURSOR I 

; REM S£T GKAPHIC CURSOR 
26(3 A=PO[flT 1 

: REM STORE COLUMN VALUE 
270 B=fl 

: REM NEW COLUMN - ALL POINTS OFF 
289 FOR J=6 TO STEP -1 

: REM EXAMISE DOTS 
29lJ C=I.ST!a/2'J) 

: POINT ON OR OFF (1 OR 0) 
300 IF C=0 LET B = B<-2-J 

r REM TliRN ON if OFF 
31ii A=A-C*2"J 

: REM GET READY FOK NEXT POINT 
32K NEXT J 

: REM DO NEXT DOT 
333 GPRINT 3; 

: REM PRINT REVERSED COLUMN 



340 NEXT I 

; REM DO NEXT COLUMN 
350 GOTO 35(i 

To use the program, enter it into your PC-2. Change line 
230 to print what ever you wish on the LCD. When you run tne 
program, the LCD wiil be reversed one column a' a time i^om 
left to right. 

Lets look at a machine language program to do the same 
thing: 



74, e, 5, 189 , 255, 65, 78, 



10 WAIT 




20 CLS 




30 GCURSOR 3 




40 PRINT "TRS- 


-30 PC-2" 


50 POKE i!J409 


72, U8 


78, 153, 


8 


61* POKE 18421 


, 76, 119 


18. 154 




a'0 CALL 184ii9 


CO ! '^ 


9*-*tKtT-{ 





139, 



72, 119, 74, a, 158, 



Looks kind of like a BASIC program doesn^t it? 

With the PC-2. you will normally use BASIC as a "vehi- 
cle" for getting the machine language routine into the com- 
puter and then executing it. 

Lines 1 0-40 ot this second program look a lot like the first 
four lines of our first program, and they do the same things- 
housekeeping and getting something on the LCD so the 
program can reverse .:t. 

Lines 50 and 60 contain the actual machine code for our 
program. POKE is a PC-2 command which tells the computer 
to "poKe" values into memory The lirst value following POKE 
(18409 and 18421) tells the computer where m memory to 
start poking and the remaining values are the values to be 
POKEd into successive memory locations. 

The CALL statement m ime 80 tells the PC-2 to "jump' to 
the memory location specified (18409) and begin executing 
the program it finds there. If you have the comouter jump to a 
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memory location and the location does not begin a valid 
program, your PC-2 may freeze or perform in an unpredict- 
able manner 

The GOTO 100 statement in line 100 "freezes" the LCD 
and lets you see the result of the reversal. 

If you have entered and RUN the second program, you 
should have noticed that your message was printed on the 
display and then, almost instantly the LCD was reversed. 
Quite a bit faster than BASIC'S many seconds to reverse the 
screen. 

This second program was copied from pages 62 and 63 
of your PC-2 Owner's Manual. Add lines 70 and 90 from 
those pages to see multiple reversals. I numbered the first 
program in so that both programs can be in memory at the 
same time for comparisons of their speed. 

DISASSEMBLY 

You may be curious about how the machine code in lines 
50 and 60 are able to reverse the display To find out, we need 
to "disassemble" the machine code. The term "disassem- 
ble" means to take the hexadecimal (hex) or decimal values 
which represent a machine code program and to translate 
those values into more recognizable assembly language op- 
eration codes (op-codes.) Once you have the op-codes you 
will be better able to understand the logic that makes the 
program work. 

Here is how I went about disassembling the machine 
code from lines 50 and 60: 

1 . Find the first value which represents an instruction to 
the computer This is the value 72 in line 50. We know 
that this is a decimal value because a hex value (on the 
PC-2) IS preceded by an &'. 

2. Locate the value 72 in the numeric op-code list. Re- 
member that the decimal values are in the second 
column. The listing looks like this: 



Hex Value 

48 i 



Decimal Value 

72 i 



Op-Code 

LDl XH.i 



The Op-code is LDl XH, i. 



3. The 'i' in the op-code tells us that this instruction 
requires another value to be complete. 

4. A quick check in the alphabetic listing gives this listing 
for LDl XH,i: 

Hex 
Op-Code 



Mnemonic Symbolic Operation 



Byte 



LDl XH.! 



i -» XH 



48 i 



Mnemonic is just another word for op-code. The sym- 
bolic operation tells us that the value 'i' is stored into 'XH' 
(the high 8-bits of the 1 6-bit X register). We already knew 
the Hex Op-Code. The 'Byte' information tells us that this 
instruction requires two iDytes (two values.) 
Since this command requires a second value, we go 
back to line 50 in the BASIC program and get the next 
value (118). 

5. I now have two values (72 118) which represent an 
instruction to the computer The instruction translates 
as: Load the high portion of the X register with the 
decimal value 118. 



6. 1 would now go back to line 50, get the next available 
value (74) and continue with steps 2-5 until I had used 
all of the available values m lines 50 and 60. 

The result of the disassembly is: 

Decimal Hex Op-Code 

Values Codes Translation 



72 118 


48 76 


LDl XH. 76H 


74 


4A00 


LDl XL. OOH 


5 


05 


LDA (X) 


189 255 


BDFF 


EAI FFH 


65 


41 


SIN X 


78 78 


4E4E 


CPI XL. 4EH 


153 8 


99 08 


BZR-08H 


76 119 


4C 77 


CPI XH. 77H 


139 6 


8B06 


BZS+ 06H 


72 119 


48 77 


LDl XH. 77H 


74 


4A00 


LDl XL. OOH 


158 18 


9E 12 


BCH-12H 


154 


9A 


RTN 



You should have noticed that I included the hex equiva- 
lents of the decimal values as I went along, and noticed that I 
used the hex values in my disassembled list (with an 'H' after 
those values for clarity) The reason for doing this is that it will 
make comparisons with the PC-2 memory map a little easier 
Also, most assembly language listings you read will use hex, 
so now is the time to start getting used to hex codes (if you 
aren't already) 

The simplest way of getting the hex codes is to get them 
from the numerical listing of op-codes that was presented 
earlier in this article. 

Great, you say but what do I do with all of this stuff? We 
will look at each line of the listing and see if we can make 
sense of it. To help the process, I am going to give each line a 
number (starting with 1 00 and incrementing by 1 0) to make 
referring to the lines a little easier 



Line 


Decimal 


Hex 


Op-Code 


100 


72 118 


48 76 


LDl XH. 76H 


110 


74 


4A00 


LDl XL, OOH 


120 


5 


05 


LDA (X) 


130 


189 255 


BDFF 


EAI FFH 


140 


65 


41 


SIN X 


150 


78 78 


4E4E 


CPI XL, 4EH 


160 


153 8 


99 08 


BZR-08H 


170 


76 119 


4C 77 


CPI XH, 77H 


180 


139 6 


8B06 


BZS+ 06H 


190 


72 119 


48 77 


LDl XH, 77H 


200 


74 


4A00 


LDl XL. OOH 


210 


158 18 


9E 12 


BCH-12H 


220 


154 


9A 


RTN 



Lines 100 and 110 load the X register with the hex value 
7600. 

Line 1 20 then tells the computer to load the A register with the 
value stored in the memory location that the X register is 
pointing to (7600). A quick glance at the PC-2 memory 
map (March MCN, pg. 26) shows us that the memory 
locations beginning at 7600H and continuing to 764DH 
are part of the PC-2's LCD display What the computer 
has done is to look at the first byte of LCD memory 
(which corresponds to the first column of dots in the 
main LCD display area) and then place a copy of the 
value in that location into the MRU's A register. 

Line 130 tells the computer to take the value in the A register 
and exclusive OR (XOR) it with the immediate value 
FFH. The bit pattern for FFH is: 1 1 1 1 1 1 1 1 . 



TRS-80 Microcomputer News, September 1983 27 



The exclusive OR operation compares each bit of the 
display value (stored in A) with a one bit from the FFH (a 
solid black, all on, column). If both bits are ones the 
computer stores a zero (0). If one bit is a one and the 
other is a zero, the computer stores a one. The net result 
is that after the EAI (XOR) operation, the A register 
contains a reversed copy of the original display byte. 

Line 140 contains the one byte instruction SIN X. This single 
instruction tells the computer to take the value which is 
currently in the A register (our reversed column image) 
and store that value in the memory location pointed to 
by the X register 

If you remember (the computer does), this is currently 
the first byte of LCD RAM. Once the value from A has 
been stored, the computer will add one to the value 
currently in the X register. 

Let's pause a moment and see what has happened. With 
only eight bytes of memory we have told the computer where 
the first column of LCD memory is (7600H), we have made a 
copy of that column, reversed the copy stored the result back 
into the first column of LCD memory (7600H) and we have 
incremented our counter (the X register) so that it now points 
to the second column of the LCD. No wonder machine 
language is so fast! 

Line 1 50 tells the computer to compare the lower 8-bits of the 
X register with tfie value 4EH. The computer will set its 
'flags' based on whether the value in XL is 4EH or not. 

Recall that the X register is pointing to LCD memory A 
glance back to the PC-2 memory map shows us that if X 
contains 764EH , it is pointing just past the end (764DH) 
of LCD display sections 1 and 3. 

Line 160 instructs the computer to examine the flags which 
were set by the CPI instruction in line 1 50. If the Z flag is 
zero (Z =0), meaning that XL did NOT contain the value 
4EH, then the computer is instructed to count back- 
wards eight bytes and continue executing the program 
from that point. If Z = 1 the computer will continue to the 
instruction in line 1 70. 

To count back eight bytes the way the computer will do it, 
we have to understand that the program counter (which is 
what will be reduced by eight) is already pointing to the first 
byte of the instruction in line 1 70. Count back eight from that 
point. You should have stopped on the 05H in line 120. The 
computer would continue executing instructions beginning 
with line 120. 

What the programmer did was to create a loop. The 
purpose of the loop is to have the computer move one byte at 
a time through the memory of LCD chips 1 and 3 (7600H - 
764DH) reversing each byte in memory as the computer 
comes to them. 

Line 1 70 tells the computer that if the value in XL was 4EH 
(from the test and compare in lines 150 and 160), then 
test the value in XH (the upper 8-bits of X) to see if a 77H 



is present. The first time the computer executes line 1 70 
the value in XH will be a 76H (put there in line 100.) 

Line 180 tells the computer to move its program counter 
forward six bytes if the value in XH WAS a 77H, Remem- 
bering that the program counter is currently pointing to 
the first byte in line 190, adding six would move the 
pointer fonward to the single byte in line 220. 

Line 190 is executed only if the value XH was not a 77H. 

Line 200 will put a OOH into XL. A quick glance at the memory 
map shows us that 7700H if the first byte of LCD display 
memory for chips 2 and 4. 

Line 21 tells the computer to subtract 1 2H (1 8 decimal) from 
its current program counter value. Since the program 
counter would be pointing at the 9AH in line 220, mov- 
ing back 1 8 decimal would make the program counter 
point to line 1 20 again. 

We already know that this will cause the computer to 
move through this new section of LCD memory (start- 
ing at 7700H this time) until the value in XL reaches 
4EH. When XL reaches 4EH (this would be the second 
time), the computer would find 77H in XH (line 1 70) and 
the program counter would be moved forward to point 
at line 220 (line 1 80). 

Line 220 is very important in any program which began by 
BASIC executing a CALL command. If you will look 
back to the BASIC program which loaded the machine 
code into memory you will find the CALL command in 
line 80. The purpose of the RTN instruction in line 220 of 
our machine language program is to return control of 
the computer to BASIC and the program which con- 
tained the CALL command. If you forget to do this, you 
may have to push the ALL RESET button on the back of 
the PC-2 to regain control of the computer JBl 
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Pocket i. v^mputer 



PC-2 Assembly Language- Part 5 



By Bruce Elliott 



This is the fifth in a series of articles which describe the 
MPU (microprocessor unit) used in the Radio Shack PC-2 
pocket computer It is our intention to include specific infor- 
mation about the 8-bit CMOS microprocessor, the machine 
code used by the microprocessor, as well as information 
about the PC-2 memory map, and certain ROM calls which 
are available. Please realize that much of what we are talking 
about refers to the overall capabilities of the MPU, and does 
not imply that all of these things can be done with a PC-2. 

The information provided in these articles is the only 
information which is available. We will try to clarify any ambi- 
guities which occur in the articles, but cannot reply to ques- 
tions outside the scope of these articles. Further, published 
copies of TRS-80 Microcomputer News are the only source of 
this information, and we will not be maintaining back issues. 
Parts One, Two, Three and Four of this series were published 
in the March, April, May, and September 1983 issues, 
respectively 

The first three articles described the MPU used in the 
PC-2, including information on the MRU's structure and its 
machine language. We also gave you details on the 
PC-2 memory map and the locations of ROM routines which 
are available. In the fourth article we presented two lists to 
make finding a particular machine language instruction eas- 
ier We also provided some information on how you might 
begin to use the information we have published. In this fifth 
article we want to present information on how to create your 
own machine language routines, and begin describing how 
to use the PC-2 ROM calls which are available. 



CREATING YOUR OWN PROGRAMS 

Last month we looked at an existing machine language 
program and described a procedure (disassembly) for deter- 
mining how the program did what it was supposed to do. This 
month I want to define a program and then describe the 
procedure for creating a workable program that fits the defini- 
tion. To make things simple, the program we are going to 
design will do only one thing— display on the LCD the key 
you press on the keyboard. I know that this program may 
sound silly After all, doesn't the PC-2 automatically display 
the key you press? The answer is no, it doesn't. Try using the 
INKEYS command. With INKEYS, if you want the character 
displayed you must display it yourself. 

What we are really doing is designing a program which 
will accept characters from the PC-2 keyboard and display 
them on the LCD. This program should show you how to do 
three important things in assembly language: first, how to get 
information from the keyboard into the computer; second, 
how to take information that is in the computer and display 
it on the LCD; and third, how to use the PC-2's ROM 
subroutines. 



In Part 1 of this series (March, 1983, pg. 26) we 
published a PC-2 memory map. It is in this section of PC-2 
memory that we find ROf^ subroutines. 

WHY DO ROM SUBROUTINES EXIST? 

In general, any computer consists of similar basic parts. 
To function, a computer must have a processing unit, input 
and output functions, working memory to store temporary 
results, and some sort of control mechanism or program. 

In the PC-2, the processing unit is the MPU which we 
have been describing in this series. The input function is 
handled primarily by the keyboard, and the output function is 
handled primarily by the LCD. The working memory is RAM 
(Random Access Memory), and the control mechanism is in 
the form of programs stored in ROM (Read Only Memory). 

In order to make the PC-2 behave so that you can use it. 
the manufacturer wrote an operating system to control the 
various functions of the computer Part of this operating sys- 
tem is instructions which control the keyboard, the LCD, and 
BASIC. This is where ROM subroutines come from. To func- 
tion properly, the PC-2 has to have a routine which looks at 
the keyboard and stores any key which may be pressed. 
Likewise, there has to be a routine somewhere which takes a 
character and displays it on the LCD. The PC-2 memory map 
tells us where some of these routines are located, and we 
will use this information to create our machine language 
program. 

IS THIS INFORMATION AVAILABLE ON OTHER 
COMPUTERS? 

Radio Shack has received permission from the original 
manufacturer of the PC-2 to disclose the information which 
we are presenting in this series of articles. The information is 
fixed, and we do not expect it to change. 

If you happen to own a different TRS-80 you may have 
tried to get similar information for that computer and you were 
told "I am sorry, but we cannot provide you with that informa- 
tion." Why? Well, there are two major reasons. The first and 
largest reason is that most computers are evolving products. 
As a computer evolves, the contents of its operating systems 
also change. II we give you information about where a partic- 
ular routine is located in the first version of a program or 
operating system, you are going to expect that information to 
be true in the second version of that program or operating 
system also. With few exceptions, every change of a machine 
language program such as an operating system means a 
relocation of ALL of the contents of that program. 

Because the contents of programs are subject to change 
with each revision, what Radio Shack typically does is to 
publish certain "published entry points." These published 
entry points won't normally change, even if the rest of the 
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program does change. Other than the published entry 
points, Radio Shack, in general, will not provide you with 
other information about the contents of the program. Using 
only published entry points protects your software from be- 
coming obsolete as soon as Radio Shack issues a new 
version of the program. 

The second major reason for not providing the informa- 
tion is that Radio Shack often does not have permission from 
the copyright holder to release the information. As an exam- 
ple, Microsoft BASIC on any of our machines is owned by 
Microsoft. Since Microsoft owns the code, they have the right 
to tell us what we can and cannot publish. 

BACK TO THE PC-2 

The stated function of our machine language program is 
to accept keyboard entries and display the pressed key on 
the LCD. 

A quick glance at the memory map for System Program 
ROM shows two keyboard scan routines and two routines 
which output single characters to the LCD. 

E243H Keyboard Scan— Wait for Character 

E42CH Keyboard Scan— No Wait 

ED4DH Output one character to LCD and increment 
cursor position by one 

ED57H Output one character to LCD 

(Remember that the H after the address, as in E243H, 
indicates that the number is in Hexadecimal notation and not 
decimal.) 

E243H 

My information on the E243H Keyboard scan routine 
tells me that the PC-2 will wait for a key to be pressed. Once a 
key has been pressed, the key's code will be placed in the 
MPU Accumulator. If a key is not pressed within about seven 
minutes, the PC-2 will be turned off automatically Once 
power-down has occurred, pressing the CSS) key will return 
the computer to the keyboard scan routine. 

E42CH 

The information on the E42CH routine states that if a key 
has been pressed, the key code will be in the accumulator If a 
key has not been pressed the accumulator will contain OOH. 

ED4DH 

To output a character using ED4DH, the ASCII code of 
the character to be displayed is placed in the accumulator 
and the routine is executed. The character will be placed at 
the current cursor position, and then the cursor position will 
be updated. 

The current cursor position is stored in memory location 
7875H. According to our information, if the old cursor posi- 
tion (before the call to ED4DH) was less than 96H the new 
cursor position (stored in 7875H) will be the old position plus 
6H. If the old cursor position was 96H or greater, the new 
position wilt be OOH. 

ED57H 

To display a character using the ROM routine at ED57H, 
place the ASCII value of the character to be displayed into the 
accumulator and execute the ED57H routine. The character 
will be displayed at the current cursor location and the cursor 
position, will not be updated. 

LET'S WRITE THE PROGRAM 

I try to program conservatively when I use machine 
language. What I mean by this is that I try to disturb as few 



things as I can. So. the first part of my program will "save the 
MPU registers." What I mean by this is that I will save a copy 
of the various registers so I can restore the MPU when I am 
finished with my program. This is done by using the appropri- 
ate push (PSH) instructions to "push" the register values onto 
the stack. 



FD C8 


PSH A 


FD 88 


PSH X 


FD 98 


PSH Y 


FD A8 


PSH U 



Now that I have saved a copy of the registers. I want to 
set the PC-2's cursor position to the left side of the LCD. This 
would make the cursor position (stored in 7578H) zero (0). 



B5 


00 


LDI 


A, 00H 


4A 


75 


LDI 


XL, 75H 


48 


78 


LDI 


XH, 78H 


0E 




STA 


(X) 



Notice that I used three LoaD Immediate (LDI) instruc- 
tions. The first LDI puts the cursor position (OOH) into the 
MRU's Accumulator (A register.) The next two LDIs load the X 
register with the address which stores cursor position 
(7578H). The fourth instruction (STA) tells the MPU to put the 
value currently in the A register into the memory location 
which IS currently in the X register. 

Now that the cursor is where I want it, it is time to get a 
keystroke from the keyboard. Since the only thing I want to do 
is to get a keystroke, I choose to use the routine which waits 
for a key to be pressed before returning. A ROM routine is 
executed by using the Subroutine JumP (SJP) command. 

BE E2 43 SJP E243H 

We learned earlier that once a key is pressed, the PC-2 
stores the ASCII value of the key in the A register Both display 
routines I am considering require the ASCII value of the 
character I want displayed to be in the A register Since the 
keyboard scan routine already put the ASCII value in the A 
register, all I need to do is use a subroutine jump to the proper 
display routine. 

BE ED 4D SJP ED4DH 

I chose to display each character in cursor position 0, so I 
used the display routine at ED4DH. 

The purpose of this program was to get a character from 
the keyboard and to display it on the LCD. My program has 
done that, so I restore the registers by POPping their values 
(in reverse order) off the stack. 



FD 2A 


POP 


U 


FD lA 


POP 


Y 


FD 0A 


POP 


X 


FD 8A 


POP 


A 



There is one final task which any machine language 
program which is called from BASIC (as this one will be) must 
perform and that is to return control of the PC-2 to BASIC. This 
is accomplished by executing a return command, 



9A 



RTN 



Here is the completed machine language program 
along with various comments so I can remember what is 
happening. 



FD C8 


PSH A 


'Save Registers 


FD 88 


PSH X 




FD 98 


PSH Y 
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FD a8 




PSH 


U 




B3 00 




LDI 


A, eiiH 


'Cursor Position 


4A 75 




LDI 


XL, 75H 


^Cutsor Storage 


M 78 




LDI 


XH, 78h 


' Locacion 


0e: 




STA 


(X) 


* Store Cursor 


BE £2 


43 


SJP 


E243H 


'Read Keyboard 


BE ED 


4D 


SJP 


E04DH 


'Display Character 


FD 2A 




POP 


U 


'Restore Registers 


FD lA 




POP 


t 




FD iJA 




POP 


X 




FD 8A 




POP 


A 





9A 



RTN 



'Return to BASIC 



TURN IT INTO A BASIC PROGRAM 

Now that I have the machine code for my program. I 
need a way to get the program into the PC- 2 and executed. A 
very straight forward way to do this in the PC-2 is to put the 
machine language program into a BASIC program shell like 
the following: 



10 WAIT 








20 DATA &FD, 


&C8, 


&FD, 


488 


30 DATA &FD, 


i98, 


iFD, 


4A8 


40 DATA &B3, 


&00, 


&4A, 


475 


30 DATA &4S, 


&78, 


&0E 




60 DATA &BE, 


iE2, 


443 




70 DATA 4 BE, 


&ED, 


&4D 




80 DATA SiFD, 


S2A, 


4FD, 


4lA 


99 DATA SFD, 


&0A, 


4FD, 


&8A 


100 DATA &9A 








110 M-16999 








120 FOR I-l ■ 


TO 30 






130 READ A 








140 POKE «+I 


> A 






1S0 NEXT I 








160 M-Mf-1 








170 PRINT " 




HEADY" 


180 CALL M 








190 GOTO 180 









Line 10 simply sets the PC-2 PRINT command delay 
time to 0. 

Lines 20-100 contain DATA statements into which I have 
placed the hexadecimal values for my machine language 



program. Notice the use of a leading '&' to indicate that the 
values are in Hex. 

Line 1 1 contains the address (minus one) where I will 
begin storing the machine language program in memory. 

Lines 1 20-1 50 POKE the machine language routine into 
PC-2 RAM memory. Line 160 updates the memory pointer 
from line 1 1 so that it contains the actual starting address of 
my routine {17000 decimal). 

Line 170 tells me that the machine language program 
has been put into memory and will begin executing with the 
next instruction. 

Line 1 80 tells BASIC to turn control of the PC-2 over to 
the machine language program which begins at location M 
{my memory pointer). The PC-2 will set the cursor position to 
zero, wait for a key to be pressed on the keyboard, display the 
proper character and return to BASIC. 

Line 190 tdls BASIC to go back to line 180 and execute 
the machine language program again. 

THAT IS ALL THERE IS TO IT! 

If you have followed this series of articles ail the way 
through, you now have enough information about the PC-2 
and how it operates to begin writing your own programs in 
machine language. 

Next month we plan on giving you some additional infor- 
mation about the various ROM subroutines which are avail- 
able to you in the PC-2. 

A CLOSING GIFT 

Operation codes (op-codes, mnemonics) are short 
names which programmers give to machine language com- 
mands to make them more readable, and more remember- 
able. We have given you several lists with op-codes and have 
provided some detail on what the commands do. At ieast one 
person has asked "How am J supposed to pronounce those 
funny looking things?" 

Below is a listing of the various PC-2 op-codes and a 
recommended "name" or pronunciation for each. 



Op-Code 


1 Suggested Name 


Op-Code Suggested Name 


Op-Code Suggested Name 


mc--' 


"" T ■' Aiifcl'wJth Carry T'- ■ - 'r'-^ 


o^'i''''"' ■ ^'S^"-^l^^^^^iiiPi| 


ADl 


Add tmmediate 'S 


POP 


;- Pop . ;:^ 


DCA 


" Decimai Add = "1 


ATT 


, Accumulator to T Register %i 


eCH .-■,"■. .'Sranct) ;^^- ; ' . ^53 


ADR 


- Add Register : ^ 


TTA 


T Register to Accumulator " >' 


SBC. ,v^: 


/: :, .^btraspl vyttti Carry .,,, , ;. ^ ,v:i 


TIN .. . .^.v. 


,.^.Tfanster,ft!>djrtcfi^ef)l ,„_.^ 


BCS , .-,..^.3f^rich Carry 5?t ■^^,*w£i*:J 


5bi 


Subiiaci Imrnea'ate 


CIN 


Ccmpare ar^d Increme'it 


_ — ' -■■»■■». 1 ._ * . _ ^ . ' -k. r- -. Ill Pi i 11 1 1 ^ lljl 1 I'll 

BoR Biancr Car'v Reset 


DCS 


Decimal SubtracI 


fiOl 


Rotate Leii 


BHS Brancr. Half Carry Sel 


AND 


AND Accumulaior 


Hon 


Rotate Rign; 


BHR Brancn Half Carry Reset 


ANI 


AND Immediate 


SHL 


Shift Left 


B2S Brancn Zero Set 


ORA 


OR Accumulator 


SHR 


Stiift Riqnt 


BZR Brancn Zero Pese! 








Decimal Rotaie RsQtit i 


eVR . Branch Overflow Reset - ' -' 


EOfl ;,■ 


, .: Exclusive OR Accumulator ; 


OPR 


EAI 


■': Exclusive OR AocufT'ijIatot 


AEX 


Accumulator Nitibte Excfiang^ 


LOP ■ ■ : "- Loop on Positive ; . ! ' y 
iSJP ;-' :," 'Subcootjna Jump ; ; :";■■;; 


(■ .: ,.■- 


immediate 


SEC . 


Set Carry . ..? 


iNc:- w--^' 


ii^fjcrement ..^.^^iisai^-^w ■; 


REC,^,.^.,. . . 


Reset Carrv....r-.,.-i«-. ^-^^^4 




DEC 


Decrement 


CDV 


i_,;ea' Divider 


VIvlJ Vector Unconuilionai 


CPA 


Compare Accumulaior 


ATP 


Acccrr-uiator to Port 


VCS Vector Carry Set 


CPI 


Compare Immediate 


ITA 


Port Input So Accumulator 


VCR Vector Carry Reset 


BIT 


B,t 


»HJ 


SetPU 


VMS Vector Half Carry Set 


Bit 


Bt iiTTied^atc 


RPU 


Resel P'J 


VHR Vector Half Carrv Reset 


n»i -' *!.* 


jHQp: ■ ' ■ 


-'Resefs display ftip-flop ' " ~ ■'? 


V/;S-°^/-;'^^'>*Hlr* 3K«f 5W; . r^rr- v^^^.. - 


LOE . : 


■ '■ Load and Oecremerii "*: ■ -^^^ 


SOP 


Sfets display flipftop ■ S 


VZR ' - , .: ■ Vectof Zero t^sset . .- . 


LIN ".-■ - 


Load and irrcremerit -, Vi; 


SPV - 


SetPV ■ - ., ' .'i 


WS ■ - ■ ■ ■ Vector Owerflow Sert "■-' ' ^ .;■ 1 


.01 


Load Immediate 


fiPV 


■■■ Reset PV ■ ■. '.- 


WR . - Vectot Overflow fleset - : , : 


IDX ; :. 


,, „;t.QadX ,. • , .. .;.;^ 


StE ., . 


Set fnterrupt Enate ■ .• ..J 


PTN , . ■ yvi..„Rstufn.ftpflri^t^QUtiri«tii:j'ii1 


STA 


i:tye Accu;'^u:a;or 


ri;!- 


Reset inierrupi Enaoie 


RTI ^etur!^ from Interrjp; 


SDE 


Store and Decrement 


AMQ 


Accumulator to Timer, Bit 9 = 


MEO Memory Enable 


SIN 


Store and Increment 


AMI 


Accumulator to Tm-ier, Bit 9 = 1 


ME1 Memory Enable 1 


STX 


Store X 


NOP 


No Operation 


^ 
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Pocket Computer 



PC-2 Assembly Language-Part 6 



By Bruc* Bllott 



This is the sixth in a series of articles which describe the 
MPU (microprocessor unit) used in the Radio Shack PC-2 
pocket computer. It is our intention to include specific infor- 
mation about the 8-bit CMOS microprocessor, the machine 
code used by the microprocessor, as well as information 
about the PC-2 memory map, and certain ROM calls which 
are available. Please realize that much of what we are talking 
about refers to the overall capabilities of the MPU, and does 
not imply that all of these things can be done with a PC-2. 

The information provided in these articles is the only 
information which is available. We will try to clarify any ambi- 
guities which occur in the articles, but can not reply to ques- 
tions outside the scope of these articles. Further, published 
copies of TRS-80 Microcomputer News are the only source of 
this information, and we will not be maintaining back issues. 

In this article we want to present information on some of 
the PC-2 ROM Calls which are available. 

When you are going to use a ROM call, there are four 
items which you want to be concerned with; 

1 . Entry Address 

2. Entry Conditions 

3. Exit Conditions 

4. Flags 

The Entry Address is the address you use in the CALL 
statement from BASIC or a SJP call from machine language. 

The Entry Conditions are conditions you must fulfill if the 
routine is to function properly Normally, entry conditions 
specify where information must be and what information you 
must put in the MPU registers for the routine to function 
properly 

The Exit Conditions tell you where you will find the result 
of the operation (if there is a result) or provide you with other 
information about how things will change as a result of using a 
particular ROM call. 

If a ROM call makes particular changes to any of the 
machine's flags, this information will be noted so you can 
properly interpret the results you get. 

A CAUTION 

I have not had time to test the information which is 
provided be\o\N on ROM calls. The information provided is as 
accurate as I could make it from the materials I am working 
with. Test any ROM call for proper operation BEFORE you 
use it in a program. Remember that the 'H' following a 
numeral indicates hexadecimal notation. 

CURSOR INFORMATION 

The PC-2 cursor pointer is located at 7875H. This loca- 
tion is used by the PC-2 to keep track of where the cursor 
should be. If you are working exclusively in machine lan- 
guage, updating 7875H is all that is needed for cursor 
location. 



If you are working from BASIC, and wish to update the 
cursor location directly using POKEs or CALLs, you must 
also set bit of location 7874H. Setting this bit from machine 
language can be accomplished by: 

dRI7874H, 01H 

This operation is done autorflatically when you use the 
CURSOR or GCURSOR BASIC commands. 

If you execute a ROM call which resets the cursor pointer 
and are going to return to BASIC, you must set bit of 
location 7874H as described above. 

If you wish to reset the cursor from machine language, 
you can use the following code: 

ANI 7874H, OFEH 

ANI 7875H, OOH 

To increment the cursor pointer, use the following: 
If you are displaying characters: 

(7875H) = (7875H) + 06H 
If you are displaying graphics: 

(7875H) = (7875H) -i- 01H 
Note: (7875H) must be between OOH and 9BH 

SYSTEM CALLS FOR THE LCD DISPLAY 

Output one character to the LCD 

1 . System call address; ED57H 

2. Entry Conditions; 

a. The ASCII character code for the character to be 
displayed must be in the ACC (Accumulator) before 
making the call. 

b. The location where the character will be placed is 
determined by the content of the cursor pointer. 

3. Exit Conditions: The cursor pxjinter does not change. 

4. Flags: Carry = The cursor stays between OOH and 95H 

on call. 
= 1 The cursor stays in 96H on the call. 
Output one character to the LCD and increment the 
cursor position by one character (6H). 

1 . System call address; ED4DH 

2. Entry Conditions: The ASCII character code for the char- 
acter to be displayed must be in the ACC (Accumulator) 
before making the call. 

3. Exit Conditions: If the cursor position t)efore the call was in 
the range OOH to 95H , then the new cursor position equfUs 
the old position plus 6H. If the cursor positbn before the 
call was 96H or larger, then the new cursor position is set 
equal to zero. 

4. Flags: 

Outputting n characters to the LCD. , 

1. System call address: EDOOH - C'H') -^Hi 

2. Entry Conditions: 

a. The 16 bit starting address for the string to be dis- 
played is placed in the U register (OOOOH < » U < = 
FFFFH). 
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b. The length of the character string is placed in the 
Accumulator (01H < = ACC < = 1AH). 

c. The cursor pointer indicates where on the LCD the 
computer is to begin displaying the string. 

3. Exit Conditions: The cursor pointer is updated. 

4. Flags: Carry = The cursor position is set to the right- 

most end of the displayed character 
string on the LCD. 
= 1 The specified character string ended in 
the 26th LCD column, or the string was 
too long to be displayed within 26 col- 
umns. The cursor will be steady, indica- 
ting the last character displayed. 
The numt)er of characters specified in the accumulator is 
output from consecutive addresses beginning with the ad- 
dress specified in the U register The characters will be placed 
on the LCD beginning with the position indicated by the 
cursor pointer The cursor pointer can be set from machine 
language, or by using the BASIC CURSOR or GCURSOR 
commands. If the information to be displayed exceeds the 
156th dot on the LCD, the excess information will not be 
displayed. 

Outputting n characters to the LCD beginning from char- 
acter position 1 . 

1 . System call address: ED3BH 

2. Entry Conditions: 

a. The 1 6 bit taeginning address location of the string to 
be displayed is stored in the U register (OOOOH < = U 
< = FFFFH). 

b. An 8 bit numt)er indicating the length of the character 
string is stored in XL (The lower half of the X register. 
01H <= XL<= 1AH). 

3. Exit Conditions: 

4. Flags: Carry = The character string has been dis- 

played in 25 or fewer columns. 
= 1 The character string reached or ex- 
ceeded the 26th column. 
Transferring 1 byte of data (1 dot column of graphic 
information) to the current cursor position. 

1 . System call address: EDEFH 

2. Entry Conditions: The byte representing the graphic pat- 
tern to be displayed is placed in the accumulator. 

3. Exit Conditions: 

a. The data is transferred to the current cursor position, 
which does not change. 

b. The contents of ACC and the X and U registers may 
change. 

c. The content of the Y register will not change. 

4. Flags: 

DATA CONVERSIONS 

Converting two bytes of ASCII code (0 - 9, A - F only) into 
a one byte hexadecimal value. 

1 . System call address: ED95H 

2. Entry Conditions: The X register should contain the ad- 
dress of the first of two consecutive bytes in memory which 
contain the ASCII characters. 

3. Exit Conditions: 

a. The X register will be incremented by 2 

b. The U and Y registers will be unchanged 

c. The ACC will contain the converted hex value. 

4. Flags: 



DISPLAY THROUGH A BUFFER 

Data can be placed into an 80-byte buffer (7BB0H - 
7BFFH) arxj then displayed as needed by specifying the 
proper cursor address in the buffer. 

1 . System call address: E8CAH 

2. Entry Conditions: 

a. Any character string which is placed in the buffer must 
have a ODH code as the last character. This means 
that the longest allowable character string is 79 char- 
acters plus the ODH end code. 

b. The Y register holds the cursor pointer for the buffer 
The documentation does not specify what value goes 
into Y. Since Y is 1 6 bits long, I presume that you would 
use the actual menrory address within the buffer 

c. Address 7880H contains a parameter which deter- 
mines how the contents of the buffer are to be 
displayed: 

If the binary content of 7880H is 0100 0000, then the 
character string stored in the buffer is output to the 
LCD using the content of the Y register as the cursor 
pointer. 

Note: If the number of characters in the buffer is 26 or 
less, then all of the characters are displayed on the 
LCD starting from the left side of the LCD. The cursor 
pointer (7875H) has no effect on this operation. If the 
number of characters in the buffer is greater than 26, 
the character in the address specified by the Y register 
and the PRECEDING 25 characters are displayed on 
the LCD starting at the left side of the LCD. 

If the binary content of 7880H is 0000 0000, then the 
cursor pointer in the Y register is ignored and the first 
26 characters stored in the buffer are output to the 
LCD. 

If the binary content of 7880H is 0010 0000, then 
numeric data stored in memory addresses 7A00H - 
7A07H are output to the LCD. 

Note: See below for a discussion of the 7A00H - 
7A07H buffer. 

3. Exit Conditions: 

4. Flags: 

The 7A0OH - 7A07H Buffer 

The PC-2 documentation describes three possible sets 
of data for the 7A00H buffer: 

Decimal Values: 

A decimal value may fall into the range 
9.999999999 X10E99 = x» 9.999999999 x 1 0E99. 

7A00H contains the exponent (negative exponents are ex- 
pressed as complements: 03H = x10E3, 1FH = 
x10E31,andFFH = x10E-1) 

7A01H contains the sign of the mantissa (OOH = +,BOH = -) 

7A02H - 7A06H contains the mantissa. 

7A07H contains OOH. 

Examples 

7A00H 7A07H 

OOH OOH OOH OOH OOH OOH OOH OOH = 0.0 

OOH OOH 12H 34H 50H OOH OOH OOH = 1.2345 

FEH OOH 98H 76H 54H 32H 12H OOH = 0.9876543212 

08H 80H 54H 32H OOH OOH OOH OOH = -5.432 x 10 
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^'nteger Values: 

An integer value may fall into the range -32768 < = x < = 

32767. 

7A00H-7A03H - Don't Care 

7A04H— B2H 

7A05H— 7A06H Binary number in complements (e.g. OOH 
OOH » 0. FFH FBH » -5. 7FH FFH = 32767) 

7A07H- Don't Care 

Character Strings: 

7A00H— 7A03H-Don't Care 

7A04H-D0H 

7A05H— Upper two bytes of string address in memory 

7A06H— Lower two bytes of string address in memory 

(string address can be in the range OOOOH - FFFFH) 

7A07H— Length of the string (range 01 H - 50H) 

Note: This last set of conditions (for strings) seems to 
imply that a string buffer can be anyplace in memory, 
rather than being restricted to 7BB0H - 7BFFH. Test this 
before relying on it. 

CASSETTE I/O AND CONTROL 

During tape I/O activities, the paper feed action of the 
printer is inhibited. 
Turn Tape Drive On 

1. System call address: BF11H 

2. Entry Conditions: MerrKjry address 7879H is used to spec- 
ify certain conditions: 

Bit 7:0 = CMT input port closes; select for CMT input. 

1 = CMT input port opens; select 1 for CMT input. 
Bit 4: = Remote 

1 = Remote 1 

3. Exit Conditions: 
4 Flags: 

Turn Tape Drive Off 

1 . System call address: BF43H 

2. Entry Conditions: 

3. Exit Conditions: Remote drive is turned off uncondition- 
ally Remote drive 1 is turned off or on depending on bit 7 of 
an unspecified address (probably 7879H). If bit 7 is the 
drive is OFF, and if bit 7 is a 1 then, the drive is ON. This bit 
can tie set using the BASIC commands RMT ON and RMT 
OFF 

4. Flags: 

Construct Tape Syrxrfironizalion Header 

The header, a 40-byte data set. consists of the synchroni- 
zation header, a file name, lite rrnxJe, and other data. This 
header is created inside the computer (addresses 7B60H - 
7B87H) and output to tape. 

1 . System call address: BBD6H 

2. Entry Conditions: The file mode (00= Machine Object, 
01 = Program, 02 = Reserve, 04 = Data) must be placed in 
the accumulator 

3. Exit Conditions: 

a. An 8 byte synchronization header will be in 7B60H - 
7B67H 

b. File mode will be in 7B68H 

c. OOH characters will tje placed in locations 7B69H - 
7B87H. 



4. Flags: 

A program file name (16 or fewer characters) can be 
placed in memory locations 7B69H - 7B78H, if you wish. 
Address locations 7B79H - 7B87H may be used for ypur own 
purposes. 

Output Tape Synchronization Header 

1 . System call address: BCE8H 

2. Entry Conditions: 

a. Bit seven of address 7879H must be zero and bit four 
will be a zero for remote and a one for remote 1 . 

b. Whether the PC-2 will beep or not during cassette I/O 
is controlled by the BASIC commands BEEP ON and 
BEEP OFF or by setting bit zero of 786BH. 

3. Exit Conditions: 

4. Flags: 

Send a Character to Tape 

1 . System call address: BDCCH 

2. Entry Conditions: Character to be output is placed in the 
Accumulator. The call to write the synchronization header 
must be used before outputting data using this system call. 

3. Exit Conditions: 

4. Flags: 

Write a tape file 

Files can be written by specifying the start address of the 
data and the number of bytes to be output. 

1 . System call address: BD3CH 

2. Entry Conditions: 

a. The X register should contain the start address 
(OOOOH < = X < = FFFFH) for the file to be written. 

b. The U register should contain the number of bytes to 
be written minus one (OOOOH < = U < = FFFFH). 

3. Exit Conditions: Check sum data is output at the rate of 2 
bytes for each 80 bytes written. The number of check sum 
bytes is not included in the U register number of bytes to be 
output. 

4. Flags: CARRY = if Output ended normally 

= 1 if BREAK key was pressed 

Read Tape Synchronization Header 

Before the header can be read from tape, you must 
construct a header using the BBD6H call. This will specify the 
file type. If you are searching for a particular file, you may 
place the file name in address locations 7B69H - 7B78H. If 
you specify a file name, the tape will be searched for a 
matching name. If you do not specify a file name (file name = 
all OOH characters) then file names will be ignored during 
input. 

1 . System call address: BCE8H 

2. Entry Conditions: 

a. build a header with file type 

b. specify a file name if you wish. 

c. Set 7879H: Bit Seven = 1 
Bit Four = for Remote 

= 1 for Remote 1 
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3. Exit Conditions: 

a. 7B91 H - 7BA0H will contain the 1 6 character file nanne 
(padded with OOH characters if file name was less than 
16 characters) 

b. 7BA1 H - 7BAFH will contain whatever was in 7B79H - 
7B87H when the file was written to tape. 

4. Rags: Carry « Reading finished 

» 1 BREAK key pressed 

Read a Character from Tape 

1. System call address: BDFOH 

2. Entry Conditions: 

3. Exit Conditions: The data value read from the tape is 
placed in the accumulator. 

4. Flags: Carry » Byte read properly 
- 1 BREAK key was pressed 

Read a file from tape 

1. System call address: BD3CH 

2. Entry Conditions: 

a. The X register contains the first memory address 
(OOOOH < - X < - FFFFH) that the file is to be loaded 
into. 

b. The U register contains the number of bytes minus 
one (OOOOH < = U< = FFFFH) to be read from tape. 

c. Address 7879H bit seven contains zero 
bit six « for data read 

= 1 for data verify 

3. Exit Conditions: 

a. Check sum information is automatically checked dur- 
ing tape input. 

b. The X register contains the address of the last data 
byte plus one. 

4. Flags: Carry = if loading ended normally 

= 1 abnormal end, check H and V flags 
H = 1 if C = 1 then BREAK key pressed 

= check V flag 
V = 1 if C = 1 and H =0 then data in memory 
and the data from the tape did not verify 
properly 
= 0ifC = 1 and H = then a check sum error 
occurred. ' 

Finishing Tape I/O Activities 

When you are finished using tape I/O you should inform the 
system. 

1. System call address: BBF5H 

2. Entry Conditions: Bit seven of 7879H should be a zero to 
terminate data output or a one to terminate data input. 

3. Exit Conditions: 

a. The serial port is reset 

b. Printer Paper Feed is enabled 

c. Cassette motor drives are turned off. 

4. Flags: 

BASIC Program Tapes 

The F>C-2 creates and reads tapes for BASIC program files 
using the file read and write routines descrit)ed here. 
Before the synchronization header is written to tape, the 



PC-2 stores the length of the program (in bytes) minu^ 
one in locations 7B85H and 7B86H. This information is 
then recorded as part of the synchronization information 
for later use in reading the file. When the header infornna- 
tion is read back during a synchronization header read, 
the length information is in 7BACH and 7BADH. 

KEYBOARD mPUT CALLS 

Scan Keyboard, wait for a key to be pressed 

1. System c^ address: E243H 

2. Entry Conditions: 

3. Exit Condrtion& 

a. Key code is in the accurifKriaic^ 

b. nriTTm cEEEi, utd CSHD do not cause 
this routine to return. 

c. Auto power off will occur after about seven nilnaias if no 
key is pressed. 

d. If the BREAK key is entered, execute the WOti^ 
ANI #FOOBH. OFDH (FDH E9H FOH OBH FOH) 

4. Flags: Carry > Accumulator has key code 

1 «= BREAK key. Accumulator - OEM 

Key Code Table 

1 2 3 4 5 6 7 

SPACE @ P p 

1 (SHIFT) F1 ! 1 A Q a q 

2 (SML) F2 " 2 B R b r 

3 F3#3CScs 

4 F4 $ 4 D T d t 

5 F5%5EUeu 

6 F6 & 6 F V f V 

7 ■ 7 G W g w 



8 


<- 


CL 


9 




RCL 


A 


I 


CA 


B 


t 


(DEF) 


C 


-» 


INS 



( 8 
) 9 



D ENTER DEL 
E BREAK > 

F OFF MODE / ? 
Scan keyboard and Return 



H 

I 

J 

K 

L 

M 

N 

O 



X 
Y 

Z 
rad 

n 

A 



h x 
' y 

J z 

k 

I 

m 

n 

o 



1. System call address: E42CH 

2. Entry Conditk}ns: 

3. Exit Conditions: 

a. If no key was pressed, accumulator ^i OOH 

b. If a key was pressed, Key code is in accumulator 

4. Rags: 

NUMERIG FUNCTION CALLS 

From the documentatiof}, it appeals that numeric func- 
tions are called with the X register powitn^ to 7A00H - 7A07H 
and the Y register pointing to 7AtOH - 7A1 7H if Y is needed. 
Results appear to always be stored in 7A0OH - 7A07H. 
Numeric data is stored in these memory areas as previously 
described, oucy §Cb \ 

Two Variable Numeric Functions 



Addition 


X + Y-»X 


EFBAH 


-7 '-^C 


Subtractton 


X-Y-X 


EFB6H 




Multiplication 


X • Y-X 


F01AH 


'lib 


Division 


X/Y-X 


F084H 


2& 


Exponentiation 


XaY-X 


F89CH 
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Single Variable Numeric Furx:tion 



Square Root 


SQRX-X 


F0E9H 


Logarithm 


LNX-X 


F161H 




LOGX-X 


F165H 


Exponentials 


EXPX-X 


F1CBH 




10AX-X 


F1D4H 


Sine 


SIN X-X 


F3A2H 


Cosine 


COS X^X 


F391H 


Tangent 


TAN X-X 


F39EH 


Arcsine 


ASN X-X 


F49AH 


ArccosJne 


ACS X-X 


F492H 


Arctangent 


ATN X-X 


F496H 




DEG X-X 


F531H 




DMS X-X 


F564H 


Absolute Value 


ABSX-X 


F597H 


Signum Function 


SON X-X 


F59DH 


Integer Function 


INT X-X 


F5BEH 



OPERATIONS WITH STRINGS 

ASC and LEN Subroutines 

1 . System call address: D9DDH 

2. Entry Conditions: 

a. Character string information is stored in 7A04H - 7A07H as 
previously described. 

b. YL = 60H for ASC 

= 64H for LEN 

3. Exit Conditions: 

a. The result is in 7A00H - 7A07H 

b. UH contains the error code (OOH is a normal finish) if an 
error occurred. 

4. Flags: 

CHR$ Subroutine 

1. System call address: D9B1H 

2. Entry Conditions: 

a. Integers from - 255 are placed into 7A07H. 

b. 7894H = 10H 

3. Exit Conditions: 

a. If UH » then a proper exit occurred, otherwise UH 
contains the error code. 

b. 7B10H contains the ASCII code 

c. 7A04H - 7A06H contain C1H 7BH 10H 

d. If the ASCII code was OOH then 7A07H contains OOH 
otherwise, 7A07H contains 01 H. 

4. Flags: 

VAL Subroutine 

1 . System call address: D9D7H 

2. Entry Conditions: string information is in 7A00H - 7A07H. 

3. Exit Conditions: 

a. The result is in 7A00H - 7A07H 

b. UH contains the error code (OOH is a norm^ finish) if an 
error occurred. 

4. Flags: 

STR$ Subroutine 

1 . System call address: D9CFH 



2. Entry Conditions: 

a. numeric value to be converted is in 7A00H - 7A07H 

b. 7894H = 10H 

3. Exit conditions: 

a. The string pointer is in 7A00H - 7A07H 

b. The actual character string is stored at 7B10H and 
following. 

c. UH contains the error code (OOH is a normal finish) if an 
error occurred. 

4. Rags: 

RIGHT$(X$,Y), LEFT$(X$.Y). and MID$(X$,Y,Z) 
Subroutines 



1 . System call address: D9F3H 




2. Entry Conditions: 








RIGHTS 


LEFTS 


MIDS 


(7890H) 


<(7891H)-8 


same 


<(7891H)-16 


(7892H) 


(7890H) + 8 


same 


(7890H) + 16 


(7894H) 


10H 


10H 


10H 


7A00H- 


Y 


Y 


Z 


7A07H 








(7890H)- 


X$ 


X$ 


xs 


(7890H) + 7 








(7890H) + 8- 


-- 


- 


Y 


(7890H) + 15 








YL 


02H 


7AH 


7BH 



3. Exit Conditions: 

a. The string pointer is in 7A00H - 7A07H 

b. The actual character string is stored at 7B10H and 
following. 

c. UH contains the error code (OOH is a normal finish) if an 
error occurred. 

4. Flags: 

Note: (7890H) and (7891 H) cannot be overwritten or 
changed. If these are changed, the routine will not 
function properly. 

String Concatenation 

1 . System call address: D925H 

2. Entry Conditions: 

a. 7894H = 10H 

b. information on the first character string is stored in 7A00H - 
7A07H 

c. Information of the second character string is stored in 
7A10H - 7A17H in the same format as previously 
described. 

3. Exit Conditions: 

a. Information on the new character string is placed in 7A00H 
- 7A07H. 

b. Actual concatenated string is put in 7B10H and following 
memory locations. 

c. If an error occurs, UH contains the error code. 

4. Flags: 
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